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1 Preface 

Author's Preface 
To The Revised Edition 

In the past two years, many people have written to me about Mapping-mostly 
complimentary. I was gratified that no serious errors were uncovered, only a few typos 
and minor corrections--a tribute to COMPUTEI's editing skills. There are too many 
people to mention everyone, but I appreciate the efforts of you, the readers; please 
continue to write to me, even if I can't answer every letter. 

Special thanks to Joe Miller of Koala Technologies (previously with Atari, author of the 
Translator disk, and frequent CompuServe user), Matt Ratcliff (remote sysop on the 
Gateway BBS), Randy Tjin of Atari Canada, Neil Harris and Richard Frick of Atari USA 
for technical Support, Bill Wilkinson for the frequent mentions in COMPUTE! magazine, 
Gary Yost of Antic, and my friend Yoram Rostas for his incessant prodding and poking 
into the machine. Also to Atari for its "open System" policy which helped make this book 
possible. 

The Atari SIG on CompuServe has been a great help and Support; it may be the best 
source of information and public domain Software for the Atari presently available. If you 
haven't used CompuServe, I highly recommend that you do so; the sysop, Ron Luks, and 
his group run a super online Operation. Ron helped me gather some of this information 
by putting up a special message asking for suggestions and answers to questions I had. 

Most of all, I owe an immeasurable amount of love, gratitude, and affection to the 
ever-patient Susan McCallan, my constant companion these past two-plus. How she 
Stands me, l've never quite figured out, but I hope she continues to do so for a long time. 
This book is for her. 

Publications and Products 

Since the first edition, OSS has released an excellent new language, Action!, as well as a 
considerably superior BASIC-BASIC XL. Action! is probably the best language yet for 
the Atari; it's a bit like C and Pascal, with a dash of Forth. I recommend it. (Russ 
Wetmore wrote Atari HomePak in Action!. Even the Commodore 64 version was written 
in Action! on the Atari.) Many Action! Utilities and programs are available on 
CompuServe's Atari SIG as well. 

Too many magazine articles have been published since the original edition to cross- 
reference all of them, but Bill Wilkinson's "Insight: Atari" in COMPUTE! magazine, Paul 
Swanson's "From Here to Atari" in Micro, plus articles in Analog, Antic, Creative 
Computing, and ROM have all provided their share of information. Atari's own magazine, 
Atari Explorer, also has many useful articles, especially for novice programmers 


As for books. The Programmer's Reference Guide for the Atari 400/800 Computers by 
David Heiserman (Howard Sams, 1984) is a good "single volume" reference, Mark 
Chasin's Assembly Language Programming for the Atari Computers (McGraw-Hill, 1984) 
is highly recommended; it provides many excellent examples strictly for Atari users, 
explaining such difficult concepts as I/O, handlers, and VBIs. Carl Evans's Atari BASIC 
Faster and Better (IJG, 1983) is an excellent technique book for BASIC programmers 
who want to improve their style and learn some machine language. 

Jerry White, well-known Atari Software author, coauthored a good compendium with Gary 
Phillips called The Atari User's 

Encyclopedia (The Book Company, 1984), Linda Schreiber's Advanced Programming 
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Techniques for Your Atari (Tab, 1983) has several good routines for graphics and strings 
in BASIC. 

COMPUTE! Books has published several good books, including COMPUTEI's Third 
Book of Atari, COMPUTEI's First and Second Book of Atari Graphics, and COMPUTEI's 
First Book of Atari Games. A real hacker's delight is The Atari BASIC Sourcebook, by Bill 
Wilkinson, Kathleen O'Brien, and Paul Laughton, which includes the entire source code 
for Atari BASIC--a must for serious BASIC users (along with Wilkinson's Inside Atari 
DOS). One of COMPUTEI's best books recently is Richard Mansfield's Machine 
Language for Beginners, a painless way to introduce yourself to machine language 
programming. 

Finally, for the real hardware buff, Atari once published their 400-800 Home Computer 
Field Service Manual (part # FD 100001); it has a wealth of data, schematics, parts lists, 
diagnostic tests, and assembly information, It's hard to get, but worth it. An 800XL Field 
Service Manual is also available. Sams has released an excellent hardware technical 
Service manual for the 800 and 800XL, it's expensive. but contains material any 
hardware hacker needs to know. 

It looks like the Atari will have a long life; it's already into its third generation (all 
compatible). I'm glad to see that the recent change in ownership did not spell the end of 
my favorite home Computer, but rather Jack Tramiel is continuing to Support and 
develop it as well as maintain compatibility between models. I'm looking forward to 
seeing his new 68000-based ST machines. 

March 1985 
lan Chadwick 
55 Kent Rd 
Toronto, Ont. 

M4L2X5 
Canada 

CompuServe 70375,1010 
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2 Foreword 


What exactly is a memory map? It is a guide to the memory locations in your Computer. 

A memory location is one of 65536 storage places called bytes in which a number is 
stored. Each of these bytes holds a number for programs, data, color, sound, System 
Operation, or is empty (i.e., has a zero in it), waiting for you to fill it with your own 
program. 

Each byte is composed of eight bits, each of which can be either a one (on) or a zero 
(off). The alterable area of memory you use for your programs is called the Random 
Access Memory (RAM), while the area used by the Atari to run things is called the Read 
Only Memory (ROM). Although some of the memory locations in the special Atari Chips 
were designed to be written to like the RAM, the rest of the ROM, including the Operating 
System ROM, cannot be altered by you since it contains routines such as the floating 
point mathematics package and the input/output routines. 

I hope that the reader is familiär enough with his or her Atari to understand some of 
these rudimentary uses of a memory map. It is not the scope of this manual to fully 
explain how to use PEEK and POKE Statements; refer to your BASIC manual. Briefly, 
however, PEEK allows you to look at the value stored in any one memory location. If you 
want that value to be printed to the screen, you must preface the PEEK Statement with a 
PRINT Statement such as: 

PRINT PEEK (708) 

If you haven't changed your color registers, this will return the number 40 to your screen. 
All bytes in the Atari can hold a number between zero and 255. POKE allows you to 
place a value into a byte, such as: 

POKE 755,4 

By doing this you will have turned your text upside down! You can return it to normal by: 
POKE 755,2 

Similarly, POKE 710,80 will turn your screen dark purple! As with PEEK, POKE can only 
involve numbers between zero and 255. You will not be able to POKE into most of the 
ROM locations since the numbers in many of them are "hard-wired," "burned" into the 
Chip, and cannot be changed in this manner. 

So how does the Atari (or other eight-bit microcomputers, for that matter) störe a number 
larger than 255? By breaking it down into two parts; the Most Significant Byte (MSB), 
which is the number divided by 256 and rounded down to the nearest whole number, and 
the Least Significant Byte (LSB), which is the original number minus the MSB. The Atari 
knows to multiply the MSB by 256 and add the LSB to get the number. For example, the 
number 45290 is stored as two parts: 234 (LSB) and 176 (MSB). 176 times 256 equals 
45056, plus 234 equals 45290 


LEAST-MOST STORAGE 

The Atari uses the Convention of storing addresses in the LSB/MSB manner in memory 
(i.e., the smaller part is in the first memory location). For example, locations 88 and 89 
störe the lowest address of the screen memory. Let's say the numbers found there are 
22 and 56, respectively. To get the decimal address, you take the MSB (stored in 89) and 
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multiply it by 256, then you add it to the LSB at 88. In our case that's 56 * 256 equals 
14336, plus 22 equals 14358. This is the address of the upper left corner of the screen. A 
simple way to do this in BASIC is: 

BYTE = PEEK (88) + PEEK (89) * 256 

The reverse (to break up a decimal location into MSB and LSB) is done by: 

MSB = INT (BYTE/256):LSB = BYTE - MSB * 256 

This process is easier for assembly language programmers who use hexadecimal 
numbers, since the right two digits are always the LSB and the two left of them are the 
MSB. For example: 

$D016 (hexadecimal for 53270) equals 16 (LSB) and DO (MSB) 

$16 equals 22 in decimal, and $D0 equals 208 decimal. Multiply the MSB by 256 and add 
22 and you get 53270. Throughout the map portion of this book I have provided both 
decimal and hexadecimal numbers together for ease of reference. In 8K BASIC, you can 
use decimal numbers only with POKE, and PEEK will return only decimal values to you. 

Hexadecimal is a base 16 used instead of the normal base ten System because it is more 
suited to the eight-bit structure of the Computer. So, when we say 2175 in decimal, what 
we really mean is: 

10000 1000 100 10 1 
0 2 17 5 

In hex, the same number is $87F. That breaks down to: 

4096 256 16 1 
0 8 7 F 

Rather than multiply each next Step up by ten, we multiply by 16. Okay, but where do we 
get "F" from? Well, if base ten has the numbers zero to nine, base 16 will have to have 
some letters added to the end to make up for the extra numbers: 

Decimal 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

Hex 0123456789ABCDEF 

So $F equals 15 in decimal. Now here's how it all relates to binary math and bits: 

Each byte can be broken up into two parts (nybbles), like this: 

0000 0000 

If each nybble is considered a separate number, in decimal, the value of each would 
ränge from zero to 15, or zero to $F. Aha! So if all the bits in each group are on (one, or 
set), then you have: 

1111 1111 Binary 

15 15 Decimal 

F F Hex 


You join the two hex numbers together and you get SFF (255 in decimal), the largest 
number a byte can hold. So you can see how we translate bytes from binary to hex, by 
translating each nybble. For example: 

1001 1101 Binary 

9 13 Decimal 

9 D Hex 

$9D equals nine times 16 plus 13, or 157 in decimal. 

0100 0110 Binary 

4 6 Decimal 

4 6 Hex 

$46 equals four times 16 plus six, or 70 in decimal. 

1111 1010 Binary 
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15 10 Decimal 

F A Hex 


$FA equals 15 times 16 plus ten, or 250 in decimal. Obviously, it is easier to do this with 
a translation program or a calculator! 

Since I will often be discussing setting bits and explaining a small amount of bit 
architecture, you should be aware of the simple procedures by which you can turn on and 
off specific bits in any location (that is, how to manipulate one of the eight individual bits 
within a byte). Each byte is a collection of eight bits: numbers are represented by turning 
on the particular bits that add up to the number stored in that byte. Bits can be either 
zero (0 equals off) or one (1 equals on, or SET). The bits are numbered zero to seven 
and represent the following decimal numbers: 

Bit 76543210 

Value 128 64 32 16 8 4 2 1 

The relationship between the bits and the powers of two should be obvious. Adding up all 
the numbers (all the bits are set) gives us 255. So each byte can hold a number between 
zero (no bits are set) and 255 (all bits are set). 

Sometimes, instead of zero, no bits set is intended to mean 256. That will be noted in the 
relevant locations. So how do you set a bit? Simple: POKE it with the appropriate 
number. For example, to set Bit 5, POKE the location with 32. To set Bits 7, 5 and 4, add 
up their values, 128 + 32 + 16, and POKE the location with the total: 176. Sometimes you 
need to set a bit without changing other bits already set, so you: 

POKE number, PEEK (number) + decimal value for the bit to be set. 

(i.e., POKE 50418, PEEK (50418) + 32) 

To turn off a bit, instead of adding the value you would subtract it with POKE number, 
PEEK (number), minus the decimal value for the bit to be turned off. Binary math is 
simple and easy to learn; it you don't understand it now, you should do further reading on 
machine language betöre attempting any serious use of this guide. 

AND, OR, And EOR 

It is useful for the reader to know how to perform Boolean logic on bits. There are three 
functions used in assembly code for bit manipulation in this manner: AND, OR and EOR 
(exclusive OR). Each requires you to use two numbers, the one being acted upon and 
the one used to perform the function. Here is a briet explanation of how these logical 
functions work: AND is usually used as a mask-to zero out unwanted bits. You compare 
two binary numbers using AND; it both bits in the same location are one, then the result 
is one. It either bit is zero, then the result is zero. For example: 

51 = 00110011 
And 15 = 00001111 


Result = 00000011 = 3 

OR is freguently used to force setting of a bit. It either bit in the original or the mask is 
one, then the result is one. For example 

65 = 01000001 
Or 128 = 10000000 


Result = 11000001 = 193 

In this case, 65 is the ATASCII "A". By ORing it with 128, we get 193, the ATASCII 
inverse "A". 

EOR "flips" bits in the original it the mask has a one in the same location. For example: 

193 = 11000001 
EOR 128 = 10000000 
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Result = 01000001 = 65 


In this case, we have returned the inverse "A" to the normal ATASCII value. An EOR with 
255 (all ones) will produce the complement of the number: 

171 = 10101011 
EOR 255 = 11111111 


Result = 01010100 = 84 


In briet: 


Original: 
0 
0 
1 
1 


Mask: And: Or: 

0 0 0 

10 1 
0 0 1 

111 


EOR: 

0 

1 

1 

0 


Atari BASIC Supports AND, OR and NOT; NOT is the logical complement where NOT1 
equals zero and NOTO equals one. If the expression is true, you get a zero; if NOT true, 
a one is returned--for example, NOT ((3 + 4) >= 6) results in zero. See COMPUTE!, May 
1981 for a machine language routine to allow you to perform Boolean bit logic using a 
USR call trom BASIC. In general, I have attempted to avoid using 6502 assembly 
language mnemonics, but have included them where I feit their use described the action 
to be taken better than a lengthy explanation. Most common are JMP (jump to location), 
JSR (jump to subroutine), RTS (return from subroutine), and RTI (return from Interrupt). 
Readers should be minimally familiär with machine language in order to understand any 
machine language subroutines used here. 

I also suggest that if the reader doesn't already have one, he or she obtain a program to 
translate hex to decimal and decimal to hex (possibly even one with binary translations 
as well). The ROM cartridge from Eastern House Software, Monkey Wrench, is useful for 
this purpose. Perhaps the easiest to use is the TI Programmer calculator from Texas 
Instruments. The examples in this book were all written using Atari 8K BASIC. They are 
intended to demonstrate the use or the effect of a particular memory location. They are 
not intended as the best examples of BASIC programming; they were written for 
simplicity, not sophistication. 

As a final note, any question or doubt as to either a particular location or explanation has 
been noted. It can't hurt to play around yourself, POKEing in the memory to see what 
other effects you can discover. If you find something I didn't, good! Please write and let 
me know. You can't hurt the machine by POKEing about in memory, although you may 
crash any program in memory, so SAVE your program first. Usually you can salvage it by 
pushing RESET, hut you may have to turn off the machine and reboot on occasion. You 
can learn a lot about your machine by simply playing around with it. 

ABOUT LANGUAGES 

The majority of the information here concerns language-independent locations and can 
be used regardless of the language you use for your programming. When the location is 
language-dependent, such as the BASIC or DOS areas, I have noted it in the proper 
section. You may exert the same control over your Atari in FORTH, Pascal, LISP, or 
whatever language you chose. You will obviously have to change the commands PEEK 
and POKE to the proper commands of your language. 

BASIC is a good language to Start with: you can use it to learn programming, to explore 
your Computer, to experiment with, and to have fun with. However, when you are ready to 
go on, you will have to learn a more efficient, faster language if you really want to make 
the best use of your Atari. Many people choose 6502 machine language because of its 
speed. If you want to stay with a high-level language, I suggest you learn FORTH. It has 
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some of the speed of machine language code with the ease of "higher level language" 
programming. Computer languages, whichever you use, are quite exact in their meaning, 
especially compared to English. Consider that in English, a tat Chance and a slim Chance 
both mean the same thing. Yet POKE, PUT, and PUSH have very different meanings in 
computerese. 

TEXT KEY 

Example: 912-927 390-39F IOCB5 

The main memory map shows you the decimal and then the hexadecimal location, the 
label (assigned by Atari and used by OS, DOS or DUP routines), and then comments 
and description. The label has no real function; it is merely a mnemonic convenience. 
Readers are referred to Stan Kelly-Bootle's delightful book, The Devil's DP Dictionary 
(McGraw-Hill Ryerson, 1981), for a full definition of the word "label". The following 
abbreviations are also noted in the comments: 

(R) Read 
(W) Write 

Sometimes the functions are different in a particular location, so each is noted. 

(D:) Disk Drive 
(F:) Screen Editor 
(S:) Display 
(K:) Keyboard 
(P:) Printer 
(C:) Cassette 

(R:) RS-232 interface. (Don't confuse this with (R) for Read.) The context should be 
obvious. 

(number) e.g. (708) Shadow Register. This is a RAM register which corresponds to a 
ROM register in one of the special Atari Chips such as GTIA or POKEY. The shadow 
location is the address you use to PEEK and POKE values. These shadow locations are 
polled by the hardware addresses 30 times a second at every stage two VBLANK 
interval, and the values used are transferred to the hardware locations for use. In order 
to effect any "permanent" change to the hardware location, you have to use the shadow 
register in BASIC (of course, every change is negated when you turn the machine off!). 
Only machine language is fast enough to use the hardware addresses directly. 

For example, location 54273 is for character control. It polls location 755 to see if the 
screen characters are to be normal, inverse, or upsidedown. To change the characters, 
you POKE location 755-the shadow -not 54273. If you POKE 54273, you will get the 
desired effect-for 1/60 of a second! As mentioned above, you can use the hardware 
addresses directly in machine language, but not in BASIC. It's just too slow. 

Sometimes, where most appropriate, a hexadecimal number will be displayed and the 
decimal number put in parentheses. The context should be obvious concerning which is 
a shadow or a decimal number. 

(* letter) refers to a source in the case of a conflicting location or explanation. See the 
source below. 

($number) refers to a hexadecimal (also called hex) number 
(i.e.: $D40E). I also refer to "pages" in memory. Pages are 
sections of 256 bytes ($100) of memory which end with 00 (i.e.: 

$E200, $C000, $600). Four pages ($400) equals 1024 bytes or 1K 
(kilobyte) of memory. 


Converted and layouted 2006 by Andreas Bertelmann for ABBUC 







13 Mapping the Atari 


GLOSSARY 

ANTIC, CTIA AND GTIA, PIA, POKEY: Special Atari 

Chips Controlling the 400/800's graphics, color and screen 
resolution, Controller jacks and sound, respectively. Located in 
ROM, locations 53248 to 54783. ANTIC also processes the Non 
Maskable Interrupts and POKEY processes the Interrupt Requests. 
These Chips, along with the 6502 microprocessor which runs the 
rest of the Atari, are housed inside your Computer, protected by 
the metal shielding underneath the plastic cover. 

BIT, BYTE: A hit is the smallest size division of memory in your 
Computer. It is so small that it can hold only one value in it: off 
(zero) or on (one). Eight hits together form a byte; this is the size of 
the memory locations discussed in this book. You will sometimes 
hear programmers talk about a half-byte called a "nybble." 

CIO: Central Input/Output routines located in ROM. Controls 
Input/Output Control Block operations. Briefly, CIO handles the 
data input and output through the device driver(s) (also known as 
device handlers), then passes control to those drivers. It's a single 
interface with which to access all peripherals in a device 
independent manner (i.e., uniform handling of data with no 
regard to the device being accessed). As an example: writing data 
to a disk file is treated in an identical manner as writing data to the 
screen; commas insert blanks between elements and both semi 
colons and commas suppress the End-Of-Line character (EOL). 

DCB: Device Control Block, used by Serial Input/Output. 

DL: Display List. This is a set of instructions which teil the ANTIC Chip 
where to find the screen display data and how that data is to be 
placed on the TV screen. 

DLI: Display List Interrupt. A DLI causes the display to stop 
Processing to temporarily run a user-written routine. 

DOS: Disk Operating System. The Software loaded from disk file 
DOSSYS that Controls all disk I/O. The latest edition of DOS is 
called DOS 2.0S (S for single density). 

DUP: Disk Utilities Package. The Software loaded from disk file 
DUPSYS that handles the DOS menu functions such as Copy. 

FMS (or sometimes DFMS): File Management System portion of 
DOS; a dedicated device driver that Controls all I/O operations for 
device "D:". 

FP: Floating Point mathematical package in ROM. 

I/O: Input/Output. 

IOCB: Input/Output Control Block. Area of RAM (locations 832 
to 959) used by CIO to define operations to devices such as the 
diskdrive (D:), printer (P:), screen display (S:), keyboard (K:) and 
screen editor (E:). ZIOCB is the page zero IOCB. 
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IRQ: Interrupt request used for serial port communication, 
peripheral devices, timing and keyboard input. IRQ's are 
processed by the POKEY Chip. 

NMI: Non-Maskable Interrupt; used for Video display and 

RESET. NMIs are processed by the ANTIC Chip. 

OS: Operating System. The resident System that runs the Atari. 

The OS resides in the 10K front cartridge Slot under the hood in 
your Atari 800. It's not visible in the 400 without taking the cover 
apart (not recommended). The OS is the same for both the 400 and 
800. There are two versions of the OS currently in circulation: the 
older "A" ROMs and the newer "B" ROMs, released around 
January 1982. The new OS is almost identical to the old OS except 
that it corrects a few bugs and changes some addresses. Not all of 
your old Software will run with the new OS. The differences 
between the two are better explained in Appendix Four. 

Although people often refer to the entire ROM area as the OS, this 
is not correct. The OS ROM is that portion of memory which holds 
the floating point package, the Atari character set, the device 
handlers, and both CIO and SIO. The actual operating System 
itself is the portion of the OS ROM which handles the I/O. 

PMG, PM Graphics: Player/missile graphics. Players and 
missiles are special moveable, user-defined, colored screen 
objects. They are often used for games, animation, or special 
Cursors. PM graphics are unique in that you can establish the 
manner (priority) in which they interact with the rest of the screen 
display and each other. 

RAM: Random Access Memory. All memory below the OS area 
(0 to 49151) which is used for storage, programs, buffers, 
Cartridges, DOS, IOCB, shadow registers, and registers for the 
special Atari Chips. Random Access means you can get to and 
from these locations at random, not that they störe information 
randomly! 

ROM: Read Only Memory. That part of high memory (locations 
49152 to 65535) in which the special hardware Chips and the OS 
reside. ROM is also used to describe cartridge memory such as the 
8K BASIC ROM, which cannot be user-altered (the cartridge 
ROM supersedes the RAM). You cannot alter most of the ROM, 
although some of the locations in the special Atari Chips may be 
temporarily set to a new value. 

With both RAM and ROM, we refer to areas with lesser values as 
being in "low" memory and locations with larger values as being in 
"high" memory. 

SIO: Serial Input/Output routines located in ROM. Controls 
serial operations including the 850 interface (R:) and cassette 
recorder (C:). Briefly, SIO Controls the Atari peripherals as per 
the request placed in its Device Control Block (DCB) by the 
proper device driver. It is also accessed by FMS for data transfer. 

VBI: VBLANK interrupt. A VBI is an interrupt that occurs 

during the VBLANK interval, causing the Computer to jump to a 
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user-specified location to process a short user-written routine 
during the VBLANK process. 

VBLANK: Vertical Blank. The interval between the time the TV 

electron beam turns off after reaching the bottom right corner of 
the screen and returns to the top left corner and turns back on 
again. This small time period may be used by machine language 
programmers for short routines without interrupting the display 
by writing a VBI (above). There are two VBLANK stages. Stage 
one is performed every VBLANK cycle (1/60 second). Stage two 
is performed either every 1/30 second or every 1/60 second when 
it doesn't interrupt time-critical code being executed. See the 
end of the memory map for the processes executed in each stage. 

SOURCES 

Letters in brackets are used in this guide to identify the source. 

(*M) Master Memory Map Ver. 2, Santa Cruz Educational Software, 1981. A memory 
guide by the same people who brought us the TRICKY TUTORIAL series. The latter are 
both tutorials and applications Utilities. The map does contain some annoying errata. 

(*Y) Your Atari Computer, by Lon Poole with Martin McNiff & Steven Cook, 
Osborne/McGraw-Hill, 1982. The best guide to date on general use of the Atari. Very 
highly recommended 

(*C) COMPUTEi's First Book of Atari, by the Editors of COMPUTE! Magazine, Small 
System Services Inc., 1981. A good collection of 

early articles that appeared in the magazine. At the time of this writing, COMPUTEi's 
Second Book of Atari had just been released. It is therefore not used as a reference 
source here, but it is a must for serious programmers. It contains a wealth of information 
on an enormous ränge of topics, including advanced graphics, forced-read modes, page 
flipping, Atari BASIC and many valuable Utilities. It should be a staple in most Atari 
owners' libraries. 

(*l) Inside Atari DOS, compiled by Bill Wilkinson, published by COMPUTE! Books, Small 
System Services, Inc., 1982. An explanation and copyrighted source code for the FMS 
portion of DOS 2.0. 

Atari BASIC: Learning by Using, by Thomas Rowley, Hofhacker Press, 1981. A lot of 
information packed into a surprisingly good little book. 

The following publications are all from Atari, Inc. I recommend them to all truly interested 
in understanding their Atari Computers: 

(*D): De Re Atari: an arcane, but indispensable reference to the Atari's operations and 
come of its most impressive aspects, by Chris Crawford et al. Serialized in BYTE 
magazine, late 1981 to mid 1982. Earlier editions have some errata, so make sure you 
obtain the latest edition. 

(*0) Operating System User's Manual and 

(*H) Hardware Manual. The famous "technical manuals" pair. Indispensable for serious 
users, albeit heavy going and not generally very Professional in their presentation of 
material. 
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(*8) 850 Interface Module Operator's Manual. The 850 manual gives many examples in 
BASIC of how to use the RS232 serial interface ports for both printer control and 
telecommunications. A very good terminal program called Jonesterm, in BASIC with 
machine language subroutines, is in the public domain and is available on many 
electronic bulletin board Systems, including CompuServe. Modem users will find many 
useful programs available in CompuServe. 

(*L) Operating Systems Listing and 

(*U) Disk Utilities Listings are the commented, copyrighted source code listings for the 
OS and the DUP.SYS portion of DOS. 

(*B) Atari BASIC Reference Manual. 

(*S) Disk Operating System II Reference Manual. 

(*A) Atari Microsoft BA SIO Instruction Manual. Microsoft BASIC makes excellent use of 
PEEKs and POKEs to accomplish many tasks. It also has many powerful commands not 
available in the 8K BASIC. 

MAGAZINES 

ANTIC Magazine had an extensive memory map, written by James Capparell, which 
continued over a number of issues. When it was used as a source, I labelled these 
references with (AM). It has a few minor errata in it. I found a number of other magazine 
articles useful, particularly those in COMPUTE! and Creative Computing. I also found 
Softside, BYTE, ANALOG and Micro magazines to be useful in the preparation of this 
book. These are all referred to throughout the book by month or issue. We owe a vote of 
thanks to the folks at Atari who published the technical manuals and the source listings 
of the operating System and the DOS. We owe another vote of thanks to Bill Wilkinson, 
of Optimized Systems Software Inc., who created the DUP portion of DOS and decided 
to publish the source code in his Inside Atari DOS. No other Computer manufacturer has, 
to my knowledge, ever provided users with such in-depth material or the details of its own 
operating Systems. Without it, none of this would have been possible: a lot of the 
information here was gleaned from those sources. 

This book is arranged in four sections: a numerical listing of the main Atari memory 
locations, their labels and their use; a general map diagram to show how the memory is 
broken down; an appendix of utility material with charts and tables, and an index/cross- 
reference guide. 

There is an awful lot of information contained here; tedious as it might appear, I suggest 
that you read this manual through at least once. Some of the information which is not 
clear in one area may be elaborated on and made clearer in another area. Wherever 
another location is referred to in one description, you should turn to the reference and 
read it after you have read through the first location. You should also refer to the 
locations used in any sample program. The more familiär you are with the memory, the 
more you will get out of your Atari. When you read the description in any memory 
location, make sure you refer to either the shadow or the hardware register mentioned 
for more information. 


POWERUP AND RESET 
COLD STARTS 

On powerup (when you turn on the Computer) the Atari OS performs a number of 
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functions, some of which are noted as defaults in the 
memory locations to follow. Among these functions are: 

Determine the highest RAM address and clear all RAM to zeroes (except locations zero 
to 15; $0 to $F). 

Erase and format the device table. 

S:, E:, K:, P:, C: handlers, SIO, CIO and interrupt processor are all initialized. 

Set the screen to GRAPHICS mode zero, 24 lines by 40 columns; set screen margins. 
Initialize the cartridge(s) if present; test for the B (right), then for the A (left) cartridge. 
Check the cartridge slots for disk boot instructions and, if they are present, boot disk. 
Transfer control to the cartridge or booted program. 

Initialize the RAM interrupt vectors at 512 to 548 ($200 to $224). 

Store zero in the following hardware registers: 53248 to 53503, 53760 to 54527 ($D000 - 
$D0FF, $D200 - $D4FF). 

The START key flag is tested and, if set (the START key is held down), CKEY (74; $4A) 
requests a cassette boot 

HATABS (794; $31A) is initialized to point to the ROM-resident device handlers. 

IOCB zero is OPENed to device E:. 

Coldstart (powerup) essentially wipes the Computer clean and should only be used for 
such. It's rather drastic. 

WARM STARTS 

When the RESET key is pushed, the OS performs some of the same functions as in 
powerup as well as some unique functions, including: 

Set the Warmstart flag (location 8) to true (255; $FF). 

Clear the OS portion of RAM from locations 16 to 127 ($10 - $7F) and 512 to 1023 
($200- $3FF). 

Reset all RAM interrupt vectors. 

Reformat the device handler table (HATABS); added vectors are lost. 

Re-initialize the cartridge(s). 

Return to GRAPHICS mode zero. 

Transfer control to the cartridge or hooted program. 

Restore the default values in RAM. 

Note that a RESET does not wipe RAM, but leaves it intact. Usually your program and 
variables will be secure when you press RESET. 
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This is considerably less drastic than powerup as above. 

There are two vectors for initialization so that these processes may be user initiated: 
58484 ($E474) for RESET and 58487 ($E477) for powerup. 

See the OS User's Manual, pages 109 to 112, and De Re Atari for a flowchart of the 
process. 
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3 Introduction 

INTRODUCTION 
Bill Wilkinson 


When I was asked by the editors at COMPUTE! to write this introduction, I was at first a little 
hesitant. How does one introduce what is essentially a map of the significant locations on the Atari 
other than by saying "This is a map of..."? 

And, yet, there is something about this book which makes it more than "simply a map." After all, if 
this were "simply" a memory map, I might "simply" use it to learn that "SSKCTL" is the "serial port 
control" and that it is at location $232. But what does that mean? Why would I want to control the 
serial port? How would I control it? 

The value of this book, then, lies not so much in the map itself as it does in the explanations of the 
various functions and Controls and the implications thereof. Even though I consider myself 
reasonably familiär with the Atari (and its ROM-based operating System), I expect to use this book 
often. 

Until now, if I needed to use an exotic location somewhere in the hardware registers, I would have 
to first locate the proper listing, then find the right routine within the listing, figure out why and how 
the routine was accessing the given register, and finally try to make sure that there were no other 
routines that also accessed this same register. Whew! Now, I will open this book, turn to the right 
page, find out what I need to know, and Start programming. 

Okay. So much for this introduction. And if you are comfortable programming your "home" 
language, the language you know best, and two or three other languages, you don't need any more 
from me. So good luck and bon voyage. 

A Common Problem 

What? Still with me? Does that mean that you are not comfortable doing memory mapped access 
in three or four languages? Well, to teil the truth, neither am I. And so the one thing I decided 
would be of most value in this introduction would be a summary of how to do memory access from 
no less than seven different languages. (Or is it eight? Well....) 

The title of this section is perhaps a little misleading (on purpose, of course, as those of you who 
read my column "Insight: Atari" in COMPUTE! Magazine can attest). The "common problem" we 
will discuss here is not a bug-type problem. Rather, it is a task-type problem which occurs in many 
common programs. Or perhaps we could approach it as a quiz. Why not? 

Quiz: Devise a set of routines which will (1) alter the current 
Cursor position (in any Standard OS graphics mode) to that 
horizontal and vertical position specified by the variables "H" and 
"V" and (2) retrieve the current Cursor position in a like manner. 

To receive full credit for this problem, implement the routine in at 
least seven different Computer languages. 

Well, our first task will be to decide what seven languages we will use. First Step in the solution: 
find out what languages are available on the Atari Computers. Here's my list: 

Atari BASIC 
BASIC A + 

Atari Microsoft BASIC 

Forth 

C 

Pascal 

PILOT 

LISP 

Assembler/Machine Language 
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Does it match yours? You don't get credit for more than one assembler or more than one Forth. 
And, actually, you shouldn't get credit for Microsoft BASIC, since it uses exactly the same method 
as Atari BASIC. And I will teil you right now that I will not attempt this task in LISP. If you are a LISP 
fanatic, more power to you; but I don't have any idea of how to approach the problem with 
Datasoft's LISP (the only LISP currently available on the Atari). Anyway, let's tackle these 
languages one at a time. 

Atari BASIC And Microsoft BASIC 

Well, how about two at a time this one time? The implementation really is the same for these two 
languages. 

Actually, the first part of this problem set is done for you in Atari BASIC: the POSITION Statement 
indeed does exactly what we want (POSITION H,V will do the assigned task). But that's cheating, 
since the object of these problems is to discover how to do machine level access without such 
aids. 

Step 1 is to look at the memory map and discover that COLCRS, at locations 85 and 86, is 
supposed to be the current graphics Cursor column (COLumn of CuRSor). Also, ROWCRS (ROW 
of CuRSor) at location 84 is the current graphics Cursor row. 

Let's tackle the row first. Assuming that the row number is in the variable "V" (as specified above), 
then we may set the row Cursor via "POKE 84,V". And, in a like manner, we may say "V = 
PEEK(84)" to assign the current Position to "V". Now that's fairly straightforward: to change a single 
memory location, use "POKE address,value"; to retrieve the contents of a single memory location, 
use "PEEK(address)". Virtually anyone who has programmed in BASIC on an Atari is at least 
familiär with the existence of PEEK and POKE, since that is the only method of accessing certain 
functions of the machine (and since the game programs published in magazines are loaded with 
PEEKsand POKEs). 

But now let's look at the Cursor column, specified as being locations 85 and 86, a "two byte" value. 
What does that mean? How can something occupy two locations? Actually, it all stems from the 
fact that a single location (byte, memory cell, character, etc.) in an Atari Computer can störe only 
256 different values (usually numbered 0 to 255). If you need to störe a bigger number, you have to 
use more bytes. For example, two contiguous bytes can be used to störe 65536 different values, 
three bytes can störe 16,777,216 different values, etc. 

Since the Atari graphics mode can have as many as 320 columns, we can't use a single one-byte 
location to störe the column number. Great! Well simply use two bytes and teil BASIC that we want 
to talk to a bigger memory cell. What's that? You can't teil BASIC to use a bigger memory cell? 
Oops. 

Ah, but have no fear. We can still perform the task; it just takes a little more work in BASIC. The 
first sub-problem is to break the column number (variable "H") into two "pieces," one for the first 
byte and one for the second. The clearest way to accomplish this is with the following code: 

Hl = INT (H/256) 

H2 = H - 256 * Hl 

Because of the nature of machine language "arithmetic," numbers designed to be two-byte 
integers must usually be divided as shown: the "high order byte" must be obtained by dividing the 
number by 256, and any fractional part of the quotient must be discarded. The "low order byte" is 
actually the remainder after all units of 256 have been extracted (often designated as "the number 
modulo 256"). 

So, if we have obtained "Hl" and "H2" as above, we can change the Cursor row as follows: 

POKE 85,H2 
POKE 86, Hl 

Notice the reversal of the order of the bytes! For the Atari (and many other microcomputers), the 
low order (or least significant) byte comes first in memory, followed by the high order (or most 
significant) byte. 
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Now, suppose we wish to avoid the use of the temporary variables "Hl" and "H2" and further 
suppose that we would now like to write the entire solution to the first problem here. Voilä: 

POKE 84,V 

POKE 86, INT (H/256) 

POKE 85,H -256 * INT(H/256) 

And we wrote those last two lines in "reverse" order so that we could öfter a substitute last line, 
which will not be explained here but which should become clear a few paragraphs hence: 

POKE 85,H - 256 * PEEK(86) 

Whew ! All that to solve just that first problem! Cheer up, it does get easier. In fact, we already 
mentioned above that you can retrieve the current row via "PEEK(84)". But how about the column? 

Again, we must remember that the column number might be big enough to require two adjacent 
bytes (locations, memory cells, etc.). Again, we could construct the larger number via the following: 

H2 = PEEK(85) 

Hl = PEEK (86) 

H = H2 + 256 * Hl 

Do you see the relationship between this and the POKEs? To "put it back together," we must 
multiply the "high order byte" by 256 (because, remember, it is actually the number of 256's we 
could obtain from the larger number) betöre adding it to the "low order byte." 

Again, let us summarize and simplify. The following code will satisfy the second problem 
requirement for BASIC: 

V = PEEK(84) 

H = PEEK (85) + 256 * PEEK(86) 

Okay. We did it. For two languages. And if you are only interested in BASIC, you can quit now. But 
if you are even a little bit curious, stick with us. It gets better. 

BASIC A + 

There might be a little bit of prejudice on my part here, but I do feel that this is the easiest language 
to explain to beginners. In fact, rather than Start with text, let's show the Solutions: 

Problem 1. 

POKE 84,V 
DPOKE 85,H 

Problem 2. 

V = PEEK (84) 

H = DPEEK(85) 

As you can see, for the single memory cell situations, BASIC A + functions exactly the same as the 
Atari and Microsoft BASICs. But for the double-byte problems, BASIC A + has an extra Statement 
and an extra function, designed specifically to interface to the double-byte "words" of the Atari's 
6502 processor. 

DPOKE (Double POKE) performs exactly the equivalent of the two POKEs required by Atari 
BASIC. DPEEK (Double PEEK) similarly combines the functions of both the Atari BASIC PEEKs. 
And that's it. Simple and straightforward. 

Forth 

I think the ease of performing the required problems in Forth will show how tightly and neatly Forth 
is tied to the machine level of the Computer. In fact, we don't really have to "invent" a way to solve 
these problems; the Solutions are within the normal specifications, expectations, and capabilities of 
virtually all Forth implementations. 

Again, I think I will show the Solutions betöre explaining: 

Problem 1. 

V @ 84 c! 
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H @ 85! 

Problem 2. 

84 c@ H! 

85 @ V! 

Now, if you are not a Forth user, that may all look rather cryptic (looks like a secret code to me), 
but let's translate it into pseudo- English. The first line of the first problem might be read like this: 

V means the location (or variable) called "V" 

@ means fetch the contents of that location 
84 means use the number 84 

c! means störe the character (byte) that we fetched first into the 
location that we fetched second 

or, in shorter form, 

"V is to be fetched as the data and 84 is to be used as the address 
of a byte-sized memory störe." 

The second line, then, would read essentially the same except that the "!" used (instead of "ci") 
implies a full word (double byte) störe, as does DPOKE in BASIC A +. 

The similarity and symmetry of the Solutions of Problems 1 and 2 are striking. Let us "read" the first 
line of the second problem: 

84 means use the number 84 (in this case, as a location) 
c@ means fetch the byte (character) at that location 

V means fetch the location (variable) called "V" 

! means störe the data fetched first into the location fetched 
second 

And, again, the only difference between this and the next line is that (instead of "c@") implies 
a double-byte fetch (again, as does DPEEK of BASIC A +). 

Neither is there space here nor it is appropriate now to discuss the foibles of Forth's reverse Polish 
notation and its stacking mechanism, but even dyed-in-the-wool algorithmic language freaks (like 
me) can appreciate its advantages in situations such as those demonstrated here. 

C 

No, that does not mean "Section C." Believe it or not, "C" is the name of a Computer language. In 
fact, it is one of the more populär Computer languages among Systems programmers. It is "the" 
language used on and by the UNIX operating System, which appears to have the inside track on 
being the replacement for CP/M on the largest microcomputers (e.g., those based on 68000 and 
other more advanced processors). 

C, somewhat like Forth, is fairly intimately tied to the machine level. For example, there are 
operators in C which will increment or decrement a memory location, just as there are such 
instructions in the assembly language of most modern microprocessors. 

Unlike Forth, however, C requires the user to declare that he/she is going beyond the scope of the 
language structures in order to "cheat" and access the machine level directly. In Standard C (i.e., 
as found on UNIX), we could change the current Cursor row via something like this: 

*((char *) 84) = V; 

Which, I suppose, is just as cryptic as Forth to the uninitiated. If you remember that parentheses 
imply precedence, just as in BASIC, you could read the above as "Use the expression '84' as a 
pointer to a character (i.e., the address of a byte--specified by 'char*') and störe V ('=') indirectly 
(the first '*’) into that location." Whew! Even experienced C users (well, some of us) often find 
themselves putting in extra parentheses to be sure the expression means what they want it to. 
Anyway, that '(char *)' is called "type casting" and is a feature of more advanced C Compilers than 
those available for the Atari. But, to be fair, it is really a poor way of doing the job, anyway. So let's 
doit "right": 
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Problem 1. 

char *pc; /* Pc is a pointer To a Byte */ 

int *pi; /* pi is a pointer To a Double Byte */ 

pc = 84; pi = 85; 

*pc = V; *pi = H; 

Problem 2. 
char *pc; 
int *pi; 

pc = 84 ; pi = 85; 

V = *pc; H = *pi; 

As with the Pascal Solutions, in the following section, we must declare the "type" of a variable, 
rather than simply assuming its existence (as in BASIC) or declaring its existence (as in Forth). 

The theory is that this will let the Compiler detect more logic errors, since you aren't supposed to do 
the wrong thing with the wrong variable type. (In practice, the C Compilers available for the Atari, 
including our own C/65, are "loose" enough to allow you to cheat most of the time.) 

Here, the declarations establish that "pc" (program counter) will always point to (i.e., contain the 
address of) a byte-sized item. But "pi" will always point to a word-sized (double byte) item. Now, 
actually, these variables point to nothing until we put an address into them, which we proceed to do 
via "pc = 84" and "pi = 85". And, finally, the actual "assignments" to or from memory are handled by 
the last line in each problem solution. Now, all this looks very complicated and hardly worthwhile, 
but the advantage of C is, once we have made all our declarations, that we can use the variables 
and structures wherever we need them in a program module, secure in the knowledge that our 
code is at least partially self-documented. 

Pascal 

Actually, Standard Pascal has no methods whatsoever available to solve these problems. 
Remember, Pascal is a "school" language, and access to the machine level was definitely not a 
desirable feature in such an environment. In fact, most of the Pascal Compilers in use today have 
invented some way to circumvent the restrictions of "Standard" Pascal, and it is largely because of 
such "inventions" that the various versions of the language are incompatible. 

Anyway, Atari Pascal does provide a method to access individual memory cells. I am not sure that 
the method I will show here is the best or easiest way, but it appears to work. Again, the solution is 
presented first: 

Note: the code in this first part is common to both problems, both 
for H and V. 

(* in the "type" declarations section *) 

charaddr = record 
row : char; 

End; 

wordaddr = record 
col : Integer; 

End; 

(* In the "var" declarations section *) 
pc : “charaddr; 
pw : “wordaddr; 

rowcrs : absolute [84] “charaddr; 
colcrs : absolute [85] “wordaddr; 


Problem 1. 

(includes the above common code) 

(* execution code in the procedure *) 

pc : = rowcrs; 
pw : = colcrs; 
pc A .row := V; 
pw A .col := H; 


Problem 2. 

(includes the above common code) 

(* again, procedure execution code *) 

pc := rowcrs; 
pw := colcrs; 

V := Pc A .row; 
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H := pw^.col; 

Did you get lost? Don't feel bad. I really feit that this could be written in a simpler fashion, but I 
wanted to present a Version which I feit reasonably sure would work under most circumstances. 

The type declarations are necessary simply to establish record formats which can be pointed to 
(and it was these record formats which I feit to be redundant). Then the variables which indeed 
point to these record formats are declared. Most importantly, the "absolute" type allows us to 
inform the Pascal Compiler that we have a constant which really is (honest, really, please let it be) 
the address of one of those record formats we wanted to point to. (And it is this "absolute" type 
which is the extension of Pascal which is not in the Standard.) 

Once we have made all our declarations, the code looks surprisingly like the C code: assign the 
absolute address to the pointer and then fetch or störe via the pointer. The overhead of the record 
element reference (the ".row" and ".col") is the only real difference (and perhaps unneeded, as I 
stated). 

PIL0T 

And here we are at last at the simplest of the Atari languages. Again, Standard PILOT has no 
defined way of accessing individual memory cells. And, again, the reason for this is that PILOT was 
(and is) a language designed for use in schools, where the last thing you want is poking around in 
memory and crashing the 100 megabyte disk with next year's budget on it. 

However, when using PILOT on an Atari Computer, the worst anyone can do is to crunch their own 
copy of their own disk or cassette. So Atari has thoughtfully provided a way to access memory cells 
from PILOT; and they have done it in a fashion that is remarkably reminiscent of BASIC. Once 
more, the solution is given first: 

Problem 1. 

C:@B84 = #V 
C:@B8 6 = #H/25 6 
C:@B85 = #H\256 

Problem 2. 

C:#V = @B84 

C:#H = @B85 + (256 * @B86) 

The trick to this is that Atari PILOT uses the "@B" operator to indicate a memory reference. When 
used on the left side of the equals sign in a C: (compute) Statement, it implies a störe (just as does 
POKE in BASIC). When used on the right side of an equals sign (or, for that matter, in Jump tests, 
etc.), it implies a memory fetch (just as does PEEK in BASIC). 

If you have already examined the BASIC code, you will probably note a marked similarity between 
it and this PILOT example. Again, we must take the larger number apart into its two components: 
the number of units of 256 each (#1-1/256) and the remainder. Notice that with PILOT we do not 
need to (nor can we) specify "INT(#H/256)". There is no INT function simply because all arithmetic 
in Atari PILOT is done with double-byte integers already. Sometimes, as in this instance, that can 
be an advantage. Other times, the lack of floating point will preclude PILOT being used for several 
applications. Notice the last line of the solution to problem 1: the use of the "\" (modulo) operator is 
essentially just a convenient shorthand available in several languages. In PILOT, 

"#H\256" 

is exactly equivalent To 

"#H - (256 * (#H/25 6) ) " . 

Atari PILOT is much more flexible and usable than the original, so why not take advantage of all its 
features? Experiment. You will be glad you did 

Assembly And Machine Language 

I almost didn't include this section, since anyone working with assembly language (and especially 
those trying to debug at the machine language level) would presumably know how to manipulate 
bytes and words. And yet, it might prove interesting to those who do not know assembler to see 
just how the 6502 processor really does perform its feats. For the purposes of the example 
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Solutions, we will presume that somewhere in our program we have coded something equivalent to 
the following: 

V * = * + l ; reserve one Byte For V 
H * = * + 2 ; reserve two bytes For H 


Those lines do not give values to V and H; they simply assign memory space to hold the eventual 
values (somewhat like DIMensioning an array in Atari BASIC, which does not put any particular 
values into the array). If we wished not only to reserve space for the "variables" V and H but also to 
assign an initial value to them, we could code this instead: 

V .BYTE 3 ; assign initial value of 3 to byte V 

H .WORD 290 ; assign initial value of 290 to word H 

Anyway, given that H and V have been reserved and have had some value(s) placed in them, here 
are the Solutions to the problems: 


Problem 1. 
LDA V 
STA 84 
LDA H 
STA 85 
LDA H + 1 
STA 8 6 


Get the contents of V 
And störe them In ROWCRS 
Then Get the first Byte of H 
And störe In first Byte of COLORS 
what ' s this? the second byte of H! 
into the second Byte of COLORS 


Problem 2. 
LDA 8 4 
STA V 
LDA 85 
STA H 
LDA 8 6 
STA H + 1 


almost, we don't need to comment this... 

it ' s just problem 1 in reverse ! 

first Byte of COLORS again 

into the least significant Byte of H 

And also the second Byte 

the high Order Byte of H 


Do you wonder why we didn't try to move both bytes of H at one time, as we did in BASIC A +, 
above? Simple: the 6502 microprocessor has no way to move two bytes in a single instruction! 
Honest! (And this is probably its biggest failing as a CPU.) Of course, if you have a macro 
assembler, you could write a macro to perform these operations. Here is an example using one 
macro assembler available for the Atari, though all macro assemblers will operate in at least a 
similar fashion. First, we define a pair of macros: 

.MACRO MOVEWORD 
LDA %1 
STA %2 
LDA %1+1 
STA %2+l 
. ENDM 

.MACRO MOVEBYTE 
LDA %1 
STA %2 
.ENDM 


Both these macros simply move their first "argument" into their second "argument" (and we won't 
define here just what "arguments" are and how they work-examine a macro assembler manual for 
more information). The first macro moves two adjacent bytes (i.e., a "word"), and the second 
moves a single byte. And now we can write our problem code in a much simpler fashion: 

Problem 1. 

MOVEBYTE V,84 
MOVEWORD H, 85 

Problem 2. 

MOVEBYTE 84, V 
MOVEWORD 8 5,H 

And yet another concept before we leave assembly language. One of the most powerful features of 
an assembler is its ability to handle equated Symbols. The real beauty of this, aside from producing 
more readable code, is that you can change all references to a location or value or whatever by 
simply changing a single equate in your source code. Thus, if somewhere near the beginning of 
our source program we had coded the following two lines: 

ROWCRS = 84 ; address of ROW CuRSor 
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COLCRS = 85 ; address of COLumn CuRSor 

then we could have "solved" the problems thus: 

Problem 1. 

MOVEBYTE V,ROWCRS 
MOVEWORD H,COLCRS 

Problem 2. 

MOVEBYTE ROWCRS,V 
MOVEWORD COLCRS,H 

And I believe that this looks as elegant and readable as any of the higher level languages! In fact, it 
looks more readable than most of the examples given above. To be fair, though, we should note 
that all of the examples could have been made more readable by substituting variable names 
instead of the absolute numbers "84" and "85," but the overhead of declaring and assigning 
variables is sometimes not worth it for languages such as BASIC and PILOT. Luckily, the 
remaining languages (Forth, C, and Pascal) all have a means of declaring constants (akin to the 
assembly language equate) which has little or no consequential overhead. So go ahead--be the 
oddball on your block and make your code readable and maintainable. It may lose you friends, but 
it might help you land a job. 

Happy Mapping 

Well, we made it. I hope you now at least have an idea of what to do to modify and examine 
various memory locations in all of the languages shown. Virtually all of the many locations mapped 
in this book will fall into one of the two categories examined: they will involve changing or 
examining either a single byte or a double byte (word, integer, address, etc.). Follow the models 
shown here, and you should have little trouble effecting your desires. For those few locations which 
do not follow the above patterns (e.g.,the System clock, which is a three-byte location in high- 
middle-low order), you may be able to accomplish your ends by considering each byte individually. 
Also, we have made no discussion here of the Atari floating point format, which is truly accessible 
in any reasonable fashion only from assembly language, and which has little pertinence to this 
memory map in any case. 

I think I would like to add only one more comment, which will be in the form of a caution: If you 
aren't sure what you are doing when changing or examining memory locations, make sure that 
your program in memory is backed up (on disk or cassette), and then make sure that you have 
"popped" (unloaded) your disks and/or tapes. It is unlikely that changing memory will cause 
Problems affecting your saved files, but why take chances. (And, if you make a mistake or are in 
doubt, re-boot the disk; don't just hit RESET, since that won't necessarily clean up all your errors.) 

Good luck and happy mapping. 
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4 Memory map 

4.1 Page 0 

Locations zero to 255 ($0 to $FF) are called "page zero" and have special importance for assembly 
language programmers since these locations are accessed faster and easier by the machine. 
Locations zero to 127 ($0 to $7F) are reserved as the OS page zero, while 128 to 255 ($80 to $FF) 
are the BASIC and the user zero page RAM. Locations zero to 1792 ($0 to $700) are all used as 
the OS and (if the cartridge is present) 8K BASIC RAM (except page six). Locations zero to 8191 
($0 to $1 FFF) are the minimum required for Operation (8K). Locations two through seven are not 
cleared on any Start Operation. 

4 . 1.1 0-127 

DECIMAL HEX LABEL 
0,1 0,1 LINZBS 

LINBUG RAM, replaced by the monitor RAM See the OS 
Listing, page 31. It seems to be used to störe the VBLANK timer 
value. One user application l've seen for location zero is in a 
metronome program in De Re Atari. Also used in cross- 
assembling the Atari OS. 

2,3 2,3 CASINI 

Cassette initialization vector: JSR through here if the cassette 
boot was successful. This address is extracted from the first six 
bytes of a cassette boot file. The first byte is ignored. The second 
contains the number of records, the third and fourth contain the 
low and high bytes of the load address, and the fifth and sixth 
contain the low and high bytes of the initialization address. 

Control upon loading jumps to the load address plus six for a 
multi-stage load and through CASINI for initialization. JSR 
through DOSVEC (10 and 11; $A,$B) to transfer control to the 
application. 

4,5 4,5 RAMLO 

RAM pointer for the memory test used on powerup. Also used to 
störe the disk boot address-normally 1798 ($706)--for the 
boot continuation routine. 

6 6 TRAMSZ 

Temporary Register for RAM size; used during powerup 
sequence to test RAM availability. This value is then moved to 
RAMTOP, location 106 ($6A). Reads one when the BASIC or the 
A (left) cartridge is plugged in. 

7 7 TSTDAT 

RAM test data register. Reads one when the B or the right 
cartridge is inserted. 

RAMLO, TRAMSZ and TSTDAT are all used in testing the RAM 
size on powerup. On DOS boot, RAMLO and TRAMSZ also act as 
temporary storage for the boot continuation address. TRAMSZ 
and TSTDAT are used later to flag whether or not the A (left) 
and/or B (right) Cartridges, respectively, are plugged in (non- 
zero equals cartridge plugged in) and whether the disk is to be 
hooted. 

Locations eight through 15 ($8-$F) are cleared on coldstart only. 

8 8 WÄRMST 
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Warmstart flag. If the location reads zero, then it is in the middle 
of powerup; 255 is the normal RESET Status. Warmstart is similar 
to pressing RESET, so should not wipe out memory, variables, or 
programs. WÄRMST is initialized to zero and will not change 
values unless POKEd or until the first time the RESET button is 
pressed. It will then read 255 ($FF). 

Warmstart normally vectors to location 58484 ($E474). WÄRMST 
is checked by the NMI Status register at 54287 ($D40F) when 
RESET is pressed to see whether or not to re-initialize the 
Software or to re-boot the disk. 

9 9 BOOT? 

Boot flag success indicator. A value of 255 in this location will 
cause the System to lockup if RESET is pressed. If BOOT? reads 
one, then the disk boot was successful; if it reads two, then the 
cassette boot was successful. If it reads zero, then neither 
peripheral was booted. 

If it is set to two, then the cassette vector at locations two and 
three will be used on RESET. Set to one, it will use the DOS 
vector at 10 and 11 ($A and $B). Coldstart attempts both a 
cassette and a disk boot and flags this location with the success or 
failure of the boots. BOOT? is checked during both disk and 
cassette boot. 

10,11 A,B DOSVEC 

Start vector for disk (or non-cartridge) Software. This is the 
address BASIC jumps to when you call up DOS. Can be set by 
user to point to your own routine, but RESET will return DOSVEC 
to the original address. To prevent this, POKE 5446 with the LSB 
and 5450 with the MSB of your vector address and re-save DOS 
using the WRITE DOS FILES Option in the menu. Locations 10 
and 11 are usually loaded with 159 and 23 ($9F and $17), 
respectively. This allows the DUPSYS section of DOS to be 
loaded when called. It is initially set to blackboard mode vector 
(58481; $E471 -called by typing "BYE" or "B." from BASIC); it 
will also vector to the cassette run address if no DOS vector is 
loaded in. If you create an AUTORUN.SYS file that doesn't end 
with an RTS instruction, you should set BOOT? to one and 580 
($244) to zero. 

12,13 C,D DOSINI 

Initialization address for the disk boot. Also used to störe the 
cassette-boot RUN address, which is then moved to CASINI (2, 

3). When you powerup without either the disk or an autoboot 
cassette tape, DOSINI will read zero in both locations. 

14,15 E,F APPMHI 

Applications memory high limit and pointer to the end of your 
BASIC program, used by both the OS and BASIC. It contains the 
lowest address you can use to set up a screen and Display List 
(which is also the highest address usable for programs and data 
below which the display RAM may not be placed). The screen 
handler will not OPEN the "S:" device if it would extend the 
screen RAM or the Display List below this address; memory 
above this address may be used for the screen display and other 
data (PM graphics, etc.). 

If an attempted screen mode change would extend the screen 
memory below APPMHI, then the screen is set up for GRAPHICS 
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mode zero; MEMTOP (locations 741, 742; $2E5, $2E6) is updated 
and an error is returned to the user. Otherwise, the memory is not 
too small for the screen editor; the mode change will take effect 
and MEMTOP will be updated. This is one of five locations used 
by the OS to keep track of the user and display memory. 

Initialized to zero by the OS at powerup. Remember, you cannot 
set up a screen display below the location specified here. 

If you use the area below the Display List for your character sets, 

PM graphics or whatever, be sure to set APPMHI above the last 
address used so that the screen or the DL data will not descend 
and destroy your own data. See RAMTOP location 106 ($6A), 

MEMTOP at 741, 742 ($2E5, $2E6), PMBASE at 54279 ($D407) 
and CHBASE at 54281 ($D409) for more Information. 

Locations 16 through 127 ($10-$7F) are cleared on either cold- or Warmstart. 

16 10 POKMSK 

POKEY Interrupts: the IRQ Service uses and alters this location. 

Shadow for 53774 ($D20E). POKE with 112 ($70; also POKE this 
same value into 53774) to disable the BREAK key. If the following 
bits are set (to one), then these interrupts are enabled (bit 
decimal values are in parentheses): 


BIT 

7 

6 

5 

4 

3 

2 


1 

0 


DECIMAL 

128 

64 

32 

16 


4 

2 

1 


Function 

The BREAK key is enabled. 

The "other key" interrupt is enabled. 

The serial Input data ready interrupt is 
enabled. 

The serial Output data required interrupt is 
enabled. 

The serial out transmission finished 
interrupt is enabled. 

The POKEY timer four interrupt is enabled 
(only In the "B" Or later versions of the OS 
ROMs). 

The POKEY timer two interrupt is enabled. 

The POKEY timer one interrupt is enabled. 


Timer interrupt enable means the associated AUDF registers are 
used as timers and will generate an interrupt request when they 
have counted down to zero. See locations 528 to 535 ($210 to 
$217) and the POKEY Chip from locations 53760 ($D200) on, for a 
full explanation. 192 ($C0) is the default on powerup. 


You can also disable the BREAK key by POKEing here with 64 
($40; or any number less than 128; $80) and also in location 
53774. The problem with simple POKEs is that the BREAK key is 
re-enabled when RESET is pressed and by the first PRINT 
Statement that displays to the screen, or any OPEN Statement that 
addresses the screen (S: or E:), or the first PRINT Statement after 
such an OPEN and any GRAPHICS command. In order to 
continually disable the BREAK key if such commands are being 
used, it's best to use a subroutine that checks the enable bits 
frequently during input and output operations, and POKEs a 
value less than 128 into the proper locations, such as: 


1000 BREAK = PEEK(16) - 128: If BREAK < 0 Then Return 
1010 POKE 16, BREAK: POKE 53774, BREAK: Return 


The new OS "B" Version ROMs have a vector for the BREAK key 
interrupt, which allows users to write their own routines to 
process the interrupt in the desired manner. It is located at 566, 
567 ($236, $237). 
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17 11 BRKKEY 

Zero means the BREAK key is pressed; any other number means 
it's not. A BREAK during I/O returns 128 ($80). Monitored by 
both keyboard, display, cassette and screen handlers. See 
location 16 ($A) for hints on disabling the BREAK key. The latest 
editions of OS provide for a proper vector for BREAK Interrupts. 
The BREAK key abort Status code is stored in STATUS (48; $30). 
It is also checked during all I/O and scroll/draw routines. During 
the keyboard handler routine, the Status code is stored in DSTAT 
(76; $4C). BRKKEY is turned off at powerup. BREAK key abort 
Status is flagged by setting BIT 7 of 53774 ($D20E). See the note 
on the BREAK key vector, above. 

18,19,20 12,13,14 RTCLOK 

Internal realtime clock. Location 20 increments every stage one 
VBLANK interrupt (1/60 second = one jiffy) until it reaches 255 
($FF); then location 19 is incremented by one and 20 is reset to 
zero (every 4.27 seconds). When location 19 reaches 255, it and 
20 are reset to zero and location 18 is incremented by one (every 
18.2 minutes or 65536 TV frames). To use these locations as a 
timer of seconds, try: 

TIME = INT((PEEK(18) * 65536 + PEEK(19) * 256 + 

PEEK(20) )/60) 

To see the count in jiffies, eliminate the 760" at the end. To see 
the count in minutes, change 760" to 7360." The maximum 
value of the RT clock is 16,777,215. When it reaches this value, it 
will be reset to zero on the next VBLANK increment. This value is 
the result of cubing 256 (i.e., 256 * 256 * 256), the maximum 
number of increments in each clock register. The RT clock is 
always updated every VBLANK regardless of the time-critical 
nature of the code being processed. 

A jiffy is actually a long time to the Computer. It can perform 
upwards of 8000 machine cycles in that time. Think of what can 
be done in the VBLANK interval (one jiffy). In human terms, a 
jiffy can be upwards of 20 minutes, as witnessed in the phrase "l'll 
be ready in a jiffy." Compare this to the oft-quoted phrase, "l'll 
be there in a minute," used by intent programmers to describe a 
time frame upwards of one hour. 

Users can POKE these clock registers with suitable values for 
their own use. The realtime clock is always updated during the 
VBLANK interval. Some of the other timer registers (locations 
536 to 544; $218 to $220) are not always updated when the OS is 
executing time critical code. 

Here's one way to use the realtime clock for a delay timer: 

10 GoSub 100 


100 POKE 20,0: POKE 19,0 
110 If Not PEEK(19) Then 110 
120 Return 

Line 110 waits to see if location 19 returns to zero and, when it does, passes control to the 
RETURN Statement. 

See COMPUTEI, August 1982, for a useful program to create a 
small realtime clock that will continue to display during your 
BASIC programming. See also De Re Atari for another realtime 
clock application. 
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21,22 15,16 BUFADR 

Indirect buffer address register (page zero). Temporary pointer 
to the current disk buffer. 

23 17 ICCOMT 

Command for CIO vector. Stores the CIO command; used to find 
the offset in the command table for the correct vector to the 
handler routine. 

24,25 18,19 DSKFMS 

Disk file manager pointer. Called JMPTBL by DOS; used as 
vector to FMS. 

26,27 1A, 1 B DSKUTL 

The disk Utilities pointer. Called BUFADR by DOS, it points to 
the area saved for a buffer for the Utilities package (data buffer; 
DBUF) or for the program area (MEMLO; 743, 744; $2E7, $2E8). 

28 IC PTIMOT 

Printer timeout, called every printer Status request. Initialized to 
30, which represents 32 seconds (the value is 64 seconds per 60 
increments in this register); typical timeout for the Atari 825 
printer is five seconds. The value is set by your printer handler 
Software. It is updated after each printer Status request Operation. 
It gets the specific timeout Status from location 748 ($2EC), which 
is loaded there by SIO. 

The new "B" type OS ROMs have apparently solved the problem 
of timeout that haunted the "A" ROMs; you saw it when the 
printer or the disk drive periodically went to sleep (timed out) for 
a few seconds, causing severe anxiety attacks in the owners who 
thought their Ataris had just mysteriously died. This is 
compounded when one removes a disk from the drive, believing 
the I/O process to be finished--only to have the drive Start up 
again after the timeout and trying to write to or read from a 
nonexistent disk. Usually both the System and the user crash 
simultaneously at this point. See the appendix for more 
Information on the new ROMs. 

29 ID PBPNT 

Print buffer pointer; points to the current Position (byte) in the 
print buffer. Ranges from zero to the value in location 30. 

30 IE PBUFSZ 

Print buffer size of printer record for current mode. Normal 
buffer size and line size equals 40 bytes; double-width print 
equals 20 bytes (most printers use their own control codes for 
expanded print); sideways printing equals 29 bytes (Atari 820 
printer only). Printer Status request equals four. PBUFSZ is 
initialized to 40. The printer handler checks to see if the same 
value is in PBPNT and, if so, sends the contents of the buffer to 
the printer. 

31 IF PTEMP 

Temporary register used by the printer handler for the value of 
the character being output to the printer. 


Locations 32 to 47 ($20 to $2F) are the ZIOCB: Page zero Input-Output Control Block. They use 
the same structure as the lOCB's at locations 832 to 959 ($340 to $3BF). The ZIOCB is used to 
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communicate I/O control data between CIO and the device handlers. When a CIO Operation is 
initiated, the information stored in the IOCB channel is moved here for use by the CIO routines. 
When the Operation is finished, the updated information is returned to the user area. 

32 20 ICHIDZ 

Händler index number. Set by the OS as an index to the device 
name table for the currently open file. If no file is open on this 
IOCB (IOCB free), then this register is set to 255 ($FF). 

33 21 ICDNOZ 

Device number or drive number Called MAXDEV by DOS to in- 
dicate the maximum number of devices. Initialized to one. 

34 22 ICCOMZ 

Command code byte set by the user to define how the rest of the 
IOCB is formatted, and what I/O action is to be performed. 

35 23 I CSTAZ 

Status of the last IOCB action returned by the device, set by the 
OS. May or may not be the same Status returned by the STATUS 
command. 

36,37 24,25 ICBALZ/HZ 

Buffer address for data transfer or the address of the file name for 
commands such as OPEN, STATUS, etc. 

38,39 26,27 ICPTLZ/HZ 

Put byte routine address set by the OS. It is the address minus 
one byte of the device's "put one byte" routine. It points to ClO's 
"IOCB not OPEN" on a CLOSE Statement. 

40,41 28,29 ICBLLZ/HZ 

Buffer length byte count used for PUT and GET operations; 
decreased by one for each byte transferred. 

42 2A ICAX1Z 

Auxiliary information first byte used in OPEN to specify the type 
of file access needed. 

43 2B ICAX2Z 

CIO working variables, also used by some serial port functions. 

Auxiliary information second byte. 

44,45 2C,2D ICAX3Z/4Z 

Used by BASIC NOTE and POINT commands for the transfer of 
disk sector numbers. These next four bytes to location 47 are also 
labelled as: ICSPRZ and are defined as spare bytes for local CIO 
use. 

46 2E ICAX5Z 

The byte being accessed within the sector noted in locations 44 
and 45. It is also used for the IOCB Number multiplied by 16. 

Each IOCB block is 16 bytes long. Other sources indicate that the 
6502 X register also contains this information. 

47 2F ICAX6Z 

Spare byte. Also labelled CIOCHR, it is the temporary storage 
for the character byte in the current PUT Operation. 
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48 30 STATUS 

Internal Status storage. The SIO routines in ROM use this byte to 
störe the Status of the current SIO Operation. See page 166 of the 
OS User's Manual for Status values. STATUS uses location 793 
($319) as temporary storage. STATUS is also used as a storage 
register for the timeout, BREAK abort and error values during 
SIO routines. 

49 31 CHKSUM 

Data frame checksum used by SIO: single byte sum with carry to 
the least significant bit. Checksum is the value of the number of 
bytes transmitted (255; $FF). When the number of transmitted 
bytes equals the checksum, a checksum sent flag is set at location 
59 ($3B). Uses locations 53773 ($D20D) and 56 ($38) for com- 
parison of values (bytes transmitted). 

50,51 32,33 BUFRLO/HI 

Pointer to the data buffer, the contents of which are transmitted 
during an I/O Operation, used by SIO and the Device Control 
Block (DCB); points to the byte to send or receive. Bytes are 
transferred to the eight-bit parallel serial output holding register 
or from the input holding register at 53773 ($D20D). This register 
is a one-byte location used to hold the eight bits which will be 
transmitted one bit at a time (serially) to or from the device. The 
Computer takes the eight bits for processing when the register is 
full or replaces another byte in it when empty after a 
transmission. 

52,53 34,35 BFENLO/HI 

Next byte past the end of the SIO and DCB data buffer described 
above. 

54 36 CRETRY 

Number of command frame retries. Default is 13 ($0D). This is the 
number of times a device will attempt to carry out a command 
such as read a sector or format a disk. 

55 37 DRETRY 

Number of device retries. The default is one. 

56 38 BUFRFL 

Data buffer full flag (255; $FF equals full). 

57 39 RECVDN 

Receive done flag (255; $FF equals done). 

58 3A XMTDON 

Transmission done flag (255; $FF equals done). 

59 3B CHKSNT 

Checksum sent flag (255; $FF equals sent). 

60 3C NOCKSM 

Flag for "no checksum follows data." Not zero means no 
checksum follows; zero equals checksum follows transmission 
data. 

61 3D BPTR 

Cassette buffer pointer: record data index into the portion of data 
being read or written. Ranges from zero to the current value at 
location 650 ($28A). When these values are equal, the buffer at 
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1021 ($3FD) is empty if reading or full if writing. Initialized to 128 
($80). 


62 3E FTYPE 

Inter-record gap type between cassette records, copied from 
location 43 ($2B; ICAX2Z) in the ZIOCB, stored there from 
DAUX2 (779; $30B) by the user. Normal gaps are a non-zero 
positive number; continuous gaps are zero (negative number). 

63 3F FEOF 

Cassette end of file flag. If the value is zero, an end of file (EOF) 
has not been reached. Any other number means it has been 
detected. An EOF record has been reached when the command 
byte of a data record equals 254 ($FE). See location 1021 ($3FD). 

64 40 FREQ 

Beep count retain register. Counts the number of beeps required 
by the cassette handler during the OPEN command for play or 
record operations; one beep for play, two for record. 

65 41 SOUNDR 

Noisy I/O flag used by SIO to Signal the beeping heard during 
disk and cassette I/O. POKE here with zero for blessed silence 
during these operations. Other numbers return the beep. In¬ 
itialized to three. The hardware solution to this problem is to turn 
your Speaker volume down. This can also be used to silence the 
digital track when playing synchronized voice/data tapes. See 
location 54018. 

66 42 CRITIC 

Critical I/O region flag; defines the current Operation as a time- 
critical section when the value here is non-zero. Checked at the 
NMI process after the stage one VBLANK has been processed. 
POKEing any number other than zero here will disable the repeat 
action of the keys and change the sound of the CTRL-2 buzzer. 

Zero is normal; setting CRITIC to a non-zero value suspends a 
number of OS processes including System Software timer coun- 
ting (timers two, three, four and five; see locations 536 to 558; 

$218 to $22E). It is suggested that you do not set CRITIC for any 
length of time. When one timer is being set, CRITIC stops the 
other timers to do so, causing a tiny amount of time to be "lost." 
When CRITIC is zero, both stage one and stage two VBLANK 
procedures will be executed. When non-zero, only the stage one 
VBLANK will be processed. 

67-73 43-49 FMZSPG 

Disk file manager System (FMS) page zero registers (seven 
bytes). 

67,68 43,44 ZBUFP 

Page zero buffer pointer to the user filename for disk I/O. 

69,70 45,46 ZDRVA 

Page zero drive pointer. Copied to here from DBUFAL and 
DBUFAH; 4905 and 4913 ($1329, $1331). Also used in FMS "free 
sector," setup and "get sector" routines. 

71,72 47,48 ZSBA 

Zero page sector buffer pointer. 
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73 49 ERRNO 

Disk I/O error number. Initialized to 159 ($9F) by FMS. 

74 4A CKEY 

Cassette boot request flag on coldstart. Checks to see if the 
START key is pressed and, if so, CKEY is set. Autoboot cassettes 
are loaded by pressing the START console key while turning the 
power on. In response to the beep, press the PLAY button on the 
recorder. 

75 4B CASSBT 

Cassette boot flag. The Atari attempts both a disk and a cassette 
boot simultaneously. Zero here means no cassette boot was suc- 
cessful. See location 9 

76 4C DSTAT 

Display Status and keyboard register used by the display handler. 

Also used to indicate memory is too small for the screen mode, 

Cursor out of ränge error, and the BREAK abort Status. 

77 4D ATRACT 

Attract mode timer and flag. Attract mode rotates colors on your 
screen at low luminance levels when the Computer is on but no 
keyboard input is read for a long time (seven to nine minutes). 

This helps to save your TV screen from "burn-out" damage suf- 
fered from being left on and not used. It is set to zero by IRQ 
whenever a key is pressed, otherwise incremented every four 
seconds by VBLANK (see locations 18 - 20; $12 - $14). When the 
value in ATRACT reaches 127 ($7F), it is then set to 254 ($FE) un- 
til attract mode is terminated. This sets the flag to reduce the 
luminance and rotate the colors when the Atari is sitting idle. 

POKE with 128 ($80) to see this effect immediately: it normally 
takes seven to nine minutes to enable the attract mode. The ÖS 
cannot "attract" color generated by DLl's, although your DU 
routine can, at a loss of time. 

Joysticks alone will not reset location 77 to zero. You will have to 
add a POKE 77,0 to your program periodically or frequently call 
in a subroutine to prevent the Atari from entering attract mode if 
you are not using any keyboard input. 

78 4E DRKMSK 

Dark attract mask; set to 254 ($FE) for normal brightness when 
the attract mode is inactive (see location 77). Set to 246 ($F6) 
when the attract mode is active to guarantee screen color 
luminance will not exceed 50% . Initialized to 254 ($FE). 

79 4F COLRSH 

Color shift mask; attract color shifter; the color registers are 
EORd with locations 78 and 79 at the stage two VBLANK (see 
locations 18 - 20; $12 - $14). When set to zero and location 78 
equals 246, color luminance is reduced 50%. COLRSH contains 
the current value of location 19, therefore is given a new color 
value every 4.27 seconds. 

Bytes 80 to 122 ($50 to $7A) are used by the screen editor and display handler. 

80 50 TEMP 

Temporary register used by the display handler in moving data to 
and from screen. Also called TMPCHR. 
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81 


51 


HOLD1 


Same as location 80. It is used also to hold the number of Display 
List entries. 


LMARGN 


82 


52 


Column of the left margin of text (GR.O or text window only). 

Zero is the value for the left edge of the screen; LMARGN is 
initialized to two. You can POKE the margin locations to set them 
to your specific program needs, such as POKE 82,10 to make the 
left margin Start ten locations from the edge of the screen. 

83 53 RMARGN 

Right margin of the text screen initialized to 39 ($27). Both 
locations 82 and 83 are user-alterable, but ignored in all 
GRAPHICS modes except zero and the text window. 

Margins work with the text window and blackboard mode and are 
reset to their default values by pressing RESET. Margins have no 
effect on scrolling or the printer. However, DELETE LINE and 
INSERT LINE keys delete or insert 40 character lines (or delete 
one program line), which always Start at the left margin and wrap 
around the screen edge back to the left margin again. The right 
margin is ignored in the process. Also, logical lines are always 
three physical lines no matter how long or short you make those 
lines. 

The beep you hear when you are coming to the end of the logical 
line works by screen position independent of the margins. Try 
setting your left margin at 25 (POKE 82,25) and typing a few lines 
of characters. Although you have just a few characters beyond 
60, the buzzer will still sound on the third line of text. 

84 54 ROWCRS 

Current graphics or text screen Cursor row, value ranging from 
zero to 191 ($BF) depending on the current GRAPHICS mode 
(maximum number of rows, minus one). This location, together 
with location 85 below, defines the Cursor location for the next 
element to be read/written to the screen. Rows run horizontally, 
left to right across the TV screen. Row zero is the topmost line; 
row 192 is the maximum value for the bottom-most line. 

85,86 55,56 COLCRS 

Current graphics or text mode Cursor column; values ränge from 
zero to 319 (high byte, for screen mode eight) depending on 
current GRAPHICS mode (maximum numher of columns minus 
one). Location 86 will always be zero in modes zero through 
seven. Home position is 0,0 (upper left-hand corner). Columns 
run vertically from the top to the bottom down the TV screen, the 
leftmost column being number zero, the rightmost column the 
maximum value in that mode. The Cursor has a complete top to 
bottom, left to right wraparound on the screen. 

ROWCRS and COLCRS define the Cursor location for the next 
element to be read from or written to in the main screen segment 
of the display. For the text window Cursor, values in locations 656 
to 667 ($290 to $29B) are exchanged with the current values in 
locations 84 to 95 ($54 to $5F), and location 123 ($7B) is set to 255 
($FF) to indicate the swap has taken place. ROWCRS and 
COLCRS are also used in the DRAW and FILL functions to 
contain the values of the endpoint of the line being drawn. The 
color of the line is kept in location 763 ($2FB). These values are 
loaded into locations 96 to 98 ($60 to $62) so that ROWCRS and 
COLCRS may be altered during the Operation. 
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BASIC's LOCATE Statement not only examines the screen, but 
also moves the Cursor one Position to the right at the next PRINT 
or PUT Statement. It does this by updating locations 84 and 85, 
above. You can override the Cursor advance by saving the 
contents of the screen betöre the LOCATE command, then 
restoring them after the LOCATE. Try: 

100 REM: THE SCREEN MUST HAVE BEEN OPENED FOR READ OR READ/WRITE 
PREVIOUSLY 

110 LOOK = PEEK(84): SEE = PEEK(85) 

120 LOCATE X,Y,THIS 

130 POKE 84, LOOK: POKE 65, SEE 

Note that CHR$(253) is a non-printing character—the beh¬ 
änd doesn’t affect the Cursor position. 

See COMPUTE!, August 1981, for an example of using COLCRS 
for dynamic data restore and updating with the screen editor and 
the lOCBs. 

87 57 DINDEX 

Display mode/current screen mode. Labelied CRMODE by (*M). 

DINDEX contains the number obtained from the low order tour 
bits of most recent open AUX1 byte. It can be used to fool the OS 
into thinking you are in a different GRAPHICS mode by 
POKEing DINDEX with a number from zero to 11. POKE with 
seven after you have entered GRAPHICS mode eight, and it will 
give you a split screen with mode seven on top and mode eight 
below. However, in order to use both halves of the screen, you 
will have to modify location 89 (below) to point to the area of the 
screen you wish to DRAW in. (See Your Atan 400/800, pp. 280 - 
283.) 

Watch for the Cursor out-of-range errors (number 141) when 
changing GRAPHICS modes in this manner and either PRINTing 
or DRAWing to the new mode screen. POKE 87 with the BASIC 
mode number, not the ANTIC mode number. 

Did you know you can use PLOT and DRAWTO in GR.0? Try 
this: 

10 GR.0 

20 PLOT 0,0: DRAWTO 10,10: DRAWTO 0,10 
30 DRAWTO 39,0: DRAWTO 20,23: DRAWTO 0,20 
40 GOTO 40 

You can also set the text window for PRINT and PLOT modes by 
POKEing 87 with the graphics mode for the window. Then you 
must POKE the address of the top left corner of the text window 
into 88 and 89 ($58, $59). The screen mode of the text window is 
stored at location 659 ($293). 

You may have already discovered that you cannot call up the 
GTIA modes from a direct command. Like the + 16 GRAPHICS 
modes, they can only be called up during a program, and the 
screen display will be reset to GR.0 on the first INPUT or PRINT 
(not PRINT#6) Statement executed in these modes. 

Since this location only takes BASIC modes, you can't POKE it 
with the other ANTIC modes such as "E", the famous "seven-and- 
a-half" mode which öfters higher resolution than seven and a four 
color display (used in Datasoft's Micropainter program). If you're 
not drawing to the screen, simply using it for display purposes, 
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you can always go into the Display List and change the 
instructions there. But if you try to draw to the screen, you risk an 
out-of-bounds error (error number 141). 

See Creative Computing, March 1982, for an excellent look at 
mode 7.5. The short subroutine below can be used to change the 
Display List to GR.7.5: 

1000 GRAPHICS 8+16: DLIST = PEEK(560)) + PEEK(561) * 256:POKE DLIST +3,78 
1010 For CHANGE = DLIST + 6 To DLIST+ 204: If PEEK(CHANGE) = 15 THEN POKE CHANGE,14 
1020 If PEEK (CHANGE) = 79 Then POKE CHANGE,78: Next CHANGE 
1030 POKE 87,7: Return 

(Actually, 15 ($F) is the DL number for the maximum memory 
mode; it also indicates modes eight through eleven. The DL's for 
these modes are identical.) Fourteen is the ANTIC E mode; 

GR.7.5 This program merely changes GR.8 to mode E in the 
Display List. The value 79 is 64+15; mode eight screen with BIT 
6 set for a Load Memory Scan (LMS) instruction (see the DL 
information in locations 560, 561; $230, $231). It does not check 
for other DL bits. 

You can also POKE 87 with the GTIA values (nine to eleven). To 
get a pseudo-text window in GTIA modes, POKE the mode 
number here and then POKE 623 with 64 for mode nine, 128 for 
mode ten, and 192 for mode eleven, then POKE 703 with tour, in 
program mode. (In command mode, you will be returned to 
GR.0.) You won't be able to read the text in the window, but you 
will be able to write to it. However, to get a true text window, 
you'll need to use a Display List Interrupt (see COMPUTEI, 

September 1982). If you don't have the GTIA Chip, it is still 
possible to simulate those GRAPHICS modes by using DINDEX 
with changes to the Display List Interrupt. See COMPUTEI, July 
1981, for an example of simulating GR.10. 

88,89 58,59 SAVMSC 

The lowest address of the screen memory, corresponding to the 
upper left corner of the screen (where the value at this address 
will be displayed). The upper left corner of the text window is 
stored at locations 660, 661 ($294, $295). 

You can verify this for yourself by: 

WINDOW = PEEK(88) + PEEK(89) * 256: POKE WINDOW,33 

This will put the letter "A" in the upper left corner in GR.0, 1 and 
2. In other GRAPHICS modes, it will print a colored block or 
bar. To see this effect, try: 

5 REM FIRST CLEAR SCREEN 

10 GRAPHICS Z: If Z > 59 Then End 

15 SCREEN = PEEK (88) + PEEK (89) * 256 

20 For N = 0 To 255: POKE SCREEN + N,N 

25 Next N: For N = 1 To 300: Next N:Z = Z + 1 

30 Goto 10 

You will notice that you get the Atari internal character code, not 
the ATASCII code. See also locations 560, 561 ($230, $231) and 
57344 ($E000). 

How do you find the entire screen RAM? First, look at the chart 
below and find your GRAPHICS mode. Then you multiply the 
number of rows-per-screen type by the number of bytes-per-line. 

This will teil you how many bytes each screen uses. Add this 
value, minus one, to the address specified by SAVMSC. 
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However, if you subtract MEMTOP (locations 741, 742; $2E5, 
$2E6) from RAMTOP (106; $6A * 256 for the number of bytes), 
you will see that there is more memory reserved than just the 
screen area. The extra is taken up by the display list or the text 
window, or is simply not used (see the second chart below). 


Mode 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9-12 

Rows 

Full 

24 

24 

12 

24 

48 

48 

96 

96 

192 

192 

Split 

— 

20 

10 

20 

40 

40 

80 

80 

160 

— 

Bytes per 

Line 

40 

20 

20 

10 

10 

20 

20 

40 

40 

40 

Columns 

per Line 

40 

20 

20 

40 

80 

80 

160 

160 

320 

80 

Memory (1) 

993 

513 

261 

273 

537 

1017 

2025 

3945 

7900 

7900 

Memory (2) 

Full 

992 

672 

420 

432 

696 

1176 

2184 

4200 

8138 

8138 

Split 

— 

674 

424 

434 

694 

1174 

2174 

4190 

8112 

— 


(1) According to the Atari BASIC Reference Manual, p.45; OS 
User's Manual, p.172, and Your Atari 400/800, p.360. 

(2) According to Your Atari 400/800, p.274, and Atari Microsoft 
Basic Manual, p.69. This is also the value you get when you 
subtract MEMTOP from RAMTOP (see above). 

For example, to POKE the entire screen RAM in GR.4, you 
would find the Start address of the screen (PEEK(88) + PEEK(89) 

* 256), then use a FOR-NEXT loop to POKE all the locations 
specified above: 

10 GRAPHICS 4: SCRN = PEEK(88) + PEEK(89) * 256 

20 For Loop = SCRN To SCRN + 479: REM 48 ROWS * 10 BYTES - 1 

30 POKE Loop,35: Next Loop 

Why the minus one in the calculation? The first byte of the screen 
is the first byte in the loop. If we add the total size, we will go one 
byte past the end of the soreen, so we subtract one from the total. 
Here's how to arrive at the value for the total amount ot memory 
located for screen use, display list and Text window: 

Total memory allocation for the screen 


Screen display Display List 


GR 

Text 

window 

unused 

always 

bytes 

cond. 

screen 

use 

unused 

bytes 

used 

bytes 

Total 

0 


none 

none 

960 

none 

32 

992 

1 

160 

none 

80 

400 

none 

34 

674 

2 

160 

none 

40 

200 

none 

24 

424 

3 

160 

none 

40 

200 

none 

34 

434 

4 

160 

none 

80 

400 

none 

54 

694 

5 

160 

none 

160 

800 

none 

54 

1174 

6 

160 

none 

320 

1600 

none 

94 

2174 

7 

160 

none 

640 

3200 

96 

94 

4190 

8 

160 

16 

1280 

6400 

80 

176 

8112 


The number of bytes from RAMTOP (location 106; $6A) is counted 
from the left text window column towards the total column. 
MEMTOP (741, 742; $2E5, $2E6) points to one byte below 
RAMTOP * 256 minus the number of bytes in the total column. If 
16 is added to the GRAPHICS mode (no text window), then the 
conditional unused bytes are added to the total. Then the bytes 
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normally added for the text window become unused, and the 
Display List expands slightly. (See COMPUTE!, September 1981.) 

When you normally PRINT CHR$(125) (clear screen), Atari sends 
zeroes to the memory starting at locations 88 and 89. It continues to 
do this until it reaches one byte less than the contents of RAMTQP 
(location 106; $6A). Here is a potential source of conflict with your 
program, however: CHR$(125)--CLEAR SCREEN-and any 
GRAPHICS command actually continue to clear the first 64 ($40) 
bytes above RAMTOP! 

It would have no effect on BASIC since BASIC is a ROM 
cartridge. The OS Source Listing seems to indicate that it ends at 
RAMTOP, but Atari assumed that there would be nothing after 
RAMTOP, so no checks were provided. Don't reserve any data 
within 64 bytes of RAMTOP or eise it will be eaten by the CLEAR 
SCREEN routine, or avoid using a CLEAR SCREEN or a 
GRAPHICS command. Scrolling the text window also clears 800 
bytes of memory above RAMTOP. 

You can use this to clear other areas of memory by POKEing the 
LSB and MSB of the area to be cleared into these locations. Your 
routine should always end on a $FF boundary (RAMTOP indicates 
the number of pages). Remember to POKE back the proper screen 
locations or use a GRAPHICS command immediately after doing 
so to set the screen right. Try this: 

10 BOTTOM = 30000: TOP = 36863: REM LOWEST And HIGHEST ADDRESS To CLEAR = $7530 & 

$8FFF 

20 RAMTOP = PEEK(106): POKE 106, INT (TOP + 1 / 256) 

30 TEST = INT(BOTTOM / 256): POKE89, TEST 
40 POKE 88. BOTTOM - 256 * TEST 
50 Print CHR$(125): POKE 106, RAMTOP 
60 GRAPHICS 0 


This will clear the specified memory area and update the address 
of screen memory. If you don't specify TOP, the CLEAR SCREEN 
will continue merrily cleaning out memory and, most likely, will 
cause your program to crash. Use it with caution. 

Here's a means to SAVE your current GR.7 screen display to disk 
using BASIC: 


1000 

1010 

1020 

1030 

REGISTERS 

1040 

#2 


SCREEN = PEEK(88) + PEEK(89) * 256 
Open #2,8,0,"D:picturename" 

MODE = PEEK(87): PUT #2, MODE:REM SAVE GR. MODE 

For SCN = 0 To 4: COL PEEK(708 + SCN): PUT #2,COL: Next SCN:REM SAVE COLOR 
For TV = SCREEN To SCREEN + 3199:Byte = PEEK(TV): PUT #2, Byte:Next TV: Close 


To use this with other screen modes, you will have to change the 
value of 3199 in line 1040 to suit your screen RAM (see the chart 
above). For example, GR.7 + 16 would require 3839 bytes (3840 
minus one). You can use the same routine with cassette by using 
device C:. To retrieve your picture, you use GET#2 and POKE 
commands. You will, however, find both routines very slow. Using 
THE CIO routine at 58454 ($E456) and the lOCBs, try this machine 
language save routine: 

10 Dirn ML$(10): B$(10): GR.8+16 

20 B$ = "your picture name":Q = PEEK(559) 

30 For N = 1 To 6: Read Byte: ML$(N,N) = CHR$(Byte): Next N 

35 DATA 104, 162,16, 76, 86, 228 

36 REM PLA,LDX,$10,JMP $E456 

40 Open #1,4,0,B$ 

50 POKE 849,1: POKE 850,7: POKE 852,PEEK(88): POKE 853,PEEK(89): POKE 856,70: POKE 
857,30: POKE 858,4 


Converted and layouted 2006 by Andreas Bertelmann for ABBUC 







43 

Mapping the Atari 




55 REM THESE POKES Set UP THE IOCB 

60 POKE 559,0: REM TURN OFF THE SCREEN To SPEED THINGS UP 

70 X = USR(ADR(ML$)): Close #1 

80 POKE 559,Q: REM TURN IT BACK On AGAIN 

Note that there is no Provision to SAVE the color registers in this program, so I suggest you have 
them SAVEd after you have SAVEd the picture. It will make it easier to retrieve them if they are at 
the end of the file. You will have to make suitable adjustments when SAVEing a picture in other 
than GR.8 + 16 - such as changing the total amount of screen memory to be SAVEd, POKEd into 
856 and 857. Also, you will need a line such as 1000 GOTO 1000 to keep a GTIA or + 16 mode 
screen intact. See the Atari column in InfoAge Magazine, July 1982, for more on this idea. See 
location 54277 ($D405) for some ideas on scrolling the screen RAM. 


A SHORT DIGRESSION 

There are two techniques used in this hook for calling a machine language program from BASIC 
with the USR command. One method is to POKE the values into a specific address -- say, page six 
-- and use the starting address for the USR call, such as X = USR(1536). For an example of this 
technique, see location 632 ($278). 

The other technique, used above, is to make a string (ML$) out of the routine by assigning to the 
elements of the string the decimal equivalents of the machine language code by using a FOR- 
NEXT and READ-DATA loop. To call this routine, you would use X = USR(ADR(ML$)). This teils 
the Atari to call the machine language routine located at the address where ML$ is stored. This 
address will change with program size and memory use. The string method won't be overwritten by 
another routine or data since it floats around safely in memory. The address of the string itself is 
stored by the string/array table at location 140 ($8C). 


90 5A OLDROW 

Previous graphics Cursor row. Updated from location 84 ($54) 
betöre every Operation. Used to determine the starting row for 
the DRAWTO and XIO 18 (FILL command). 

91,92 5B,5C OLDCOL 

Previous graphics Cursor column. Updated from locations 85 and 
86 ($55, $56) betöre every Operation. These locations are used by 
the DRAWTO and XIO 18 (FILL) commands to determine the 
starting column of the DRAW or FILL 

93 5D OLDCHR 

Retains the value of the character under the Cursor used to 
restore that character when the Cursor moves 

94,95 5E,5F OLDADR 

Retains the memory location of the current Cursor location. Used 
with location 93 (above) to restore the character under the Cursor 
when the Cursor moves 

96 60 NEWROW 

Point (row) to which DRAWTO and XIO 18 (FILL) will go. 

97,98 61,62 NEWCOL 

Point (column) to which DRAWTO and XIO 18 (FILL) will go. 
NEWROW and NEWCOL are initialized to the values in 
ROWCRS and COLCRS (84 to 86; $54 to $56) above, which 
represent the destination end point of the DRAW and FILL 
functions. This is done so that ROWCRS and COLCRS can be 
altered during these routines. 

99 63 LOGCOL 

Position of the Cursor at the column in a logical line. A logical 
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line can contain up to three physical lines, so LOGCOL can 
ränge between zero and 119. Used by the display handler. 

100,101 64,65 ADRESS 

Temporary storage used by the display handler for the Display 
List address, line buffer (583 to 622; $247 to $26E), new MEMTOP 
value after DL entry, row column address, DMASK value, data to 
the right of Cursor, scroll, delete, the clear screen routine and for 
the screen address memory (locations 88, 89; $58, $59). 

102,103 66,67 MLTTMP 

Also called OPNTMP and TOADR; first byte used in OPEN as 
temporary storage. Also used by the display handler as 
temporary storage. 

104,105 68,69 SAVADR 

Also called FRMADR. Temporary storage, used with ADRESS 
above for the data under the Cursor and in moving line data on 
the screen. 

106 6A RAMTOP 

RAM size, defined by powerup as passed from TRAMSZ (location 
6), given in the total number of available pages (one page equals 
256 bytes, so PEEK(106) * 256 will teil you where the Atari thinks 
the last usable address --byte-- of RAM is). MEMIOP (741, 

742; $2E5. $2E6) may not extend below this value. In a 48K Atari, 

RAMTOP is initialized to 160 ($A0), which points to location 
40960 ($A000). The user's highest address will be one byte less 
than this value. 

This is initially the same value as in location 740. PEEK(740) / 4 or 
PEEK(106) / 4 gives the number of 1K blocks. You can fool the 
Computer into thinking you have less memory than you actually 
have, thus reserving a relatively safe area for data (for your new 
character set or player/missile characters, for example) or 
machine language subroutines by: 

POKE(106), PEEK(106) - # of pages you want to reserve. 

The value here is the number of memory pages (256-byte blocks) 
present. This is useful to know when changing GR.7 and GR.8 
screen RAM. If you are reserving memory for PM graphics, 

POKE 54279, PEEK(106) - # of pages you are reserving before 
you actually POKE 106 with that value. To test to see if you have 
exceeded your memory by reserving too much memory space, 
you can use: 

10 SIZE = (PEEK (10 6) - # of pages) * 256 

20 If SIZE < = PEEK(144) + PEEK(145) * 256 Then Print "TOO MUCH MEMORY USED 

If you move RAMTOP to reserve memory, always issue a 
GRAPHICS command (even issuing one to the same GRAPHICS 
mode you are in will work) immediately so that the display list 
and data are moved beneath the new RAMTOP. 

You should note that a GRAPHICS command and a CLEAR 
command (or PRINT CHR$(125)) actually clear the first 64 bytes 
above RAMTOP (see location 88; $58 for further discussion). 

Scrolling the text window of a GRAPHICS mode clears up to 800 
($320) bytes above RAMTOP (the text window scroll actually 
scrolls an entire GR.O screen-worth of data, so the unseen 20 
lines * 40 bytes equals 800 bytes). PM graphics may be safe 
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(unless you scroll the text window) since the first 384 or 768 bytes 
(double or single line resolution, respectively) are unused. 

However, you should take both of these effects into account when 
writing your programs. 

To discover the exact end of memory, use this routine (it's a fad 
slow): 

10 RAMTOP = 106: TOP = PEEK(RAMTOP) 

20 Byte = TOP * 256: TEST = 255 - PEEK(Byte): POKE Byte,TEST 
30 If PEEK (Byte) = TEST Then TOP = TOP +1: POKE Byte, 255 - TEST 
40 GoTo 20 

50 Print "MEMORY ENDS AT Byte 

One caution: BASIC cannot always handle setting up a display 
list and display memory for GRAPHICS 7 and GRAPHICS 8 
when you modify this location by less than 4K (16 pages; 4096 
bytes). Some bizarre results may occur if you use PEEK(106) - 8 
in these modes, for example. Use a minimum of 4K (PEEK(106) - 
16) to avoid trouble. This may explain why some people have 
difficulties with player/missile graphics in the hi-res (high 
resolution; GR.7 and GR.8) modes. See location 54279 ($D407). 

Another alternative to reserving memory in high RAM is to save 
an area below MEMLO, location 743 ($2E7: below your BASIC 
program). See also MEMTOP, locations 741, 742 ($2E5, $2E6). 

107 6B BUFCNT 

Buffer count: the screen editor current logical line size counter. 

108,109 6C,6D BUFSTR 

Editor low byte (AM). Display editor GETCH routine pointer 
(location 62867 for entry; $F593). Temporary storage; returns the 
character pointed to by BUFCNT above. 

110 6E BITMSK 

Bit mask used in bit mapping routines by the OS display handler 
at locations 64235 to 64305 ($FAEB to $FB31). Also used as a 
display handler temporary storage register. 

111 6F SHFAMT 

Pixel justification: the amount to shift the right justified pixel data 
on output or the amount to shift the input data to right justify it. 

Prior to the justification process, this value is always the same as 
that in 672 ($2A0). 

112,113 70,71 ROWAC 

ROWAC and COLAC (below) are both working accumulators for 
the control of row and column point plotting and the increment 
and decrement functions. 

114,115 72,73 COLAC 

Controls column point plotting. 

116,117 74,75 ENDPT 

End point of the line to be drawn. Contains the larger value of 
either DELTAR or DELTAC (locations 118 and 119, below) to be 
used in conjunction with ROWAC/COLAC (locations 112 and 
114, above) to control the plotting of line points. 

118 76 DELTAR 

Delta row; contains the absolute value of NEWBOW (location 96; 

$60) minus ROWCRS (location 84; $54). 
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119,120 77,78 DELTAC 

Delta column; contains the absolute value of NEWCOL (location 
97; $61) minus the value in COLCRS (location 85; $55). These 
delta register values, along with locations 121 and 122 below, are 
used to define the slope of the line to be drawn. 

121 79 ROWINC 

The row increment or decrement value (plus or minus one). 

122 7A COLINC 

The column increment or decrement value (plus or minus one). 

ROWINC and COLINC control the direction of the line drawing 
routine. The values represent the signs derived from the value in 
NEWROW (location 96; $60) minus the value in ROWCRS 
(location 84; $54) and the value in NEWCOL (locations 97, 98; 

$61, $62) minus the value in COLCRS (locations 85, 86; $55, 

$56). 

123 7B SWPFLG 

Split-screen Cursor control. Equal to 255 ($FF) if the text window 
RAM and regulär RAM are swapped; otherwise, it is equal to 
zero. In split-screen modes, the graphics Cursor data and the text 
window data are frequently swapped in order to get the values 
associated with the area being accessed into the OS data base 
locations 84 to 95 ($54 to $5F). SWPFLG helps to keep track of 
which data set is in these locations. 

124 7C HOLDCH 

A character value is moved here betöre the control and shift logic 
are processed for it. 

125 7D INSDAT 

Temporary storage byte used by the display handler for the 
character under the Cursor and end of line detection. 

126,127 7E,7F COUNTR 

Starts out containing the larger value of either DELTAR (location 
118; $76) or DELTAC (location 119; $77). This is the number of 
iterations required to draw a line. As each point on a line is 
drawn, this value is decremented. When the byte equals zero, the 
line is complete (drawn). 

4 . 1.2 128-255 

User and/or BASIC page zero RAM begins here. Locations 128 to 145 ($80 to $91) are for BASIC 
program pointers; 146 to 202 ($92 to $CA) are for miscellaneous BASIC RAM; 203 to 209 ($CB to 
$D1) are unused by BASIC, and 210 to 255 ($D2 to $FF) are the floating point routine work area. 
The Assembler Editor cartridge uses locations 128 to 176 ($80 to $B0) for its page zero RAM. 
Since the OS doesn't use this area, you are free to use it in any non-BASIC or non-cartridge 
environment. If you are using another language such as FORTH, check that program’s memory 
map to see if any conflict will occur. See COMPUTERS First Book of Atari, pages 26 to 53, for a 
discussion of Atari BASIC structure, especially that using locations 130 to 137 ($82 to $89). 
Included in the tutorials are a memory analysis, a line dump, and a renumber utility. See also De 
Re Atari, BYTE, February 1982, and the locations for the BASIC ROM 40960 to 49151 ($A000 to 
$BFFF). 

DECIMAL HEX LABEL 

128,129 80,81 LOMEM 

Pointer to BASIC’s low memory (at the high end of OS RAM 
space). The first 256 bytes of the memory pointed to are the token 
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output buffer, which is used by BASIC to convert BASIC 
Statements into numeric representation (tokens; see locations 
136, 137; $88, $89). This value is loaded from MEMLO (locations 
743, 744; $2E7, $2E8) on initialization or the execution of a NEW 
command (not on RESET!). Remember to update this value when 
changing MEMLO to reserve space for drivers or buffers. 

When a BASIC SAVE is made, two blocks of information are 
written: the first block is the seven pointers from LOMEM to 
STARP (128 to 141; $80 to $8D). The value of LOMEM is 
subtracted from each of these two-byte pointers in the process, so 
the first two bytes written will both be zero. The second block 
contains the following: the variable name table, the variable 
value table, the tokenized program, and the immediate mode 
line. 

When a BASIC LOAD is made, BASIC adds the value at MEMLO 
(743, 744; $2E7, $2E8) to each of the two-byte pointers SAVEd as 
above. The pointers are placed back in page zero, and the values 
of RUNSTK (142, 143; $8E, $8F) and MEMTOP (144, 145; $90, 
$91) are set to the value in STARP. Then 256 bytes are reserved 
above the value in MEMLO for the token output buffer, and the 
program is read in immediately following this buffer. 

When you don't have DOS or any other application program 
using low memory loaded, LOMEM points to 1792 ($700). When 
DOS 2.0 is present, it points to 7420 ($1CFC). When you change 
your drive and data buffer defaults (see 1801, 1802; $709, $70A), 
you will raise or lower this figure by 128 bytes for each buffer 
added or deleted, respectively. When you boot up the RS-232 
handler, add another 1728 ($6C0) bytes used. 

LOMEM is also called ARGOPS by BASIC when used in 
expression evaluation. When BASIC encounters any kind of 
expression, it puts the immediate results into a stack. ARGOPS 
points to the same 256 byte area; for this Operation it is reserved 
for both the argument and operator stack. It is also called 
OUTBUFF for another Operation, pointing to the same 256 byte 
buffer as ARGOPS points to. Used by BASIC when checking a 
line for syntax and Converting it to tokens. This buffer 
temporarily Stores the tokens betöre moving them to the 
program. 

130,131 82,83 VNTP 

Beginning address of the variable name table. Variable names 
are stored in the Order input into your program, in ATASCII 
format. You can have up to 128 variable names. These are stored 
as tokens representing the variable number in the tokenized 
BASIC program, numbered from 128 to 255 ($80 to $FF). 

The table continues to störe variable names, even those no longer 
used in your program and those used in direct mode entry. It is 
not cleared by SAVEing your program. LOADing a new program 
replaces the current VNT with the one it retrieves from the file. 

You must LIST the program to tape or disk to save your program 
without these unwanted variables from the table. LIST does not 
SAVE the variable name or variable value tables with your 
program. It Stores the program in ATASCII, not tokenized form, 
and requires an ENTER command to retrieve it. You would use a 
NEW Statement to clear the VNT in memory once you have 
LISTed your program. 

Each variable name is stored in the order it was entered, not the 
ATASCII order. With numeric (scalar) variables, the MSB is set 
on the last character in a name. With string variables, the last 
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character is a "$" with the MSB (BIT 7) set. With array variables, 
the last character is a "(" with the MSB set. Setting the MSB turns 
the character into its inverse representation so it can be easily 
recognized. 

You can use variable names for GOSUB and GOTO routines, 
such as: 

10 CALCULATE = 1000 


100 GoSub CALCULATE 


This can save a lot of bytes for a frequently called routine. But 
remember, each variable used for a GOSUB or GOTO address 
uses one of the 128 possible variable names. A disadvantage of 
using variable names for GOTO and GOSUB references is when 
you try to use a line renumbering program. Line renumbering 
programs will not change references to lines with variable 
names, only to lines with numbered references. 

Here's a small routine you can add to the Start of your BASIC 
program (or the end if you change the line numbers) to print out 
the variable names used in your program. You call it up with a 
GOTO Statement in direct mode: 


1 POKE 1664, PEEK(130): POKE 1665, PEEK (131) 

2 If PEEK(1664) = PEEK(132) Then If PEEK(1665) = PEEK(133) Then STOP 

3 Print CHR$(PEEK(PEEK(1664) + PEEK (1665) * 256))); 

4 If PEEK(PEEK(1664) + PEEK(1665) * 256)) > 127 Then Print""; 

5 If PEEK(1664) = 255 Then POKE 166 4, 0: POKE 1665, PEEK(1665) + 1: GOTO 2 

6 POKE 1664, PEEK(1664) + 1: GoTo 2 

See COMPUTER October 1981. 

132,133 84,85 VNTD 

Pointer to the ending address of the variable name table plus one 
byte. When fewer than 128 variables are present, it points to a 
dummy zero byte. When 128 variables are present, this points to 
the last byte of the last variable name, plus one. 

It is offen useful to be able to list your program variables; using 
locations 130 to 133, you can do that by: 

10 VARI = PEEK(130) + PEEK(131) * 256 :REM This gives you the Start of the table. 

20 For VARI = VARI To PEEK(132) + PEEK(133) * 256 - 1: 

Print CHR$(PEEK(VARI) - 128 * PEEK(VARI > 127)); 

CHR$(27 + 128 * PEEK(VARI) > 127));:Next VARI 
25 REM this finds the End of the vari able name table 
(remember table is End + 1). 

Then PRINTs ASCII characters < 128 
30 NUM = 0: For VARI = PEEK(130) + PEEK(313) * 256 To 

PEEK(132) + PEEK(131) * 256 - 1:NUM = NUM + (PEEK(VARI) 

< 127):Next VARI: Print NUM; "Variables in use" 


Or try this, for a possibly less opaque example of the same routine: 

1000 NUM = 0: For Loop = PEEK (130) + 

PEEK(131) * 256 To PEEK(132) + 

PEEK(133) * 256 - 1 
1010 If PEEK (Loop) < 128 Then Print 
CHR$(PEEK (Loop) );: GoTo 1030 
1020 Print CHR$(PEEK (Loop) - 128): N 
UM - NUM + 1 

1030 Next Loop: Print; Print NUM; " 

VARIABLES IN USE": End 


134,135 86,87 VVTP 

Address for the variable value table. Eight bytes are allocated for 
each variable in the name table as follows: 
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Byte 

Variable 

1 


2 

3 4 

5 6 

7 8 

Scalar 

00 

var 

# 

six Byte BCD constant 

Array;DIMed 

65 

var 

# 

offset 

first 

second 

unDIMed 

64 



from 

Dim + 1 

Dim + 1 





STARP 



String;DIMed 

129 

var 

# 

offset 

length 

Dim 

unDIMed 

128 



from 







STARP 




In scalar (undimensioned numeric) variables, bytes three to eight 
are the FP number; byte three is the exponent; byte tour contains 
the least significant two decimal digits, and byte eight contains 
the most significant two decimal digits. 

In array variables, bytes five and six contain the size plus one of 
the first dimension of the array (DIM + 1; LSB/MSB), and bytes 
seven and eight contain the size plus one of the second dimension 
(the second DIM + 1; LSB/MSB). 

In string variables, bytes five and six contain the current length 
of the variable (LSB MSB), and bytes seven and eight contain the 
actual dimension (up to 32767). There is an undocumented 
BASIC Statement, "COM," mentioned only in the BASIC 
Reference Manual's index, which executes exactly the same as 
the "DIM" Statement (see Your Atari 400/800, p.346). Originally, 
it was to be used to implement "common" variables. 

In all cases, the first byte is always one of the number listed on the 
chart above (you will seldom, if ever, see the undimensioned 
values in a program). This number defines what type of variable 
information will follow. The next byte, var # (variable number), is 
in the ränge from zero to 127. Offset is the number of bytes from 
the beginning of STARP at locations 140 and 141 ($8C, $8D). 

Since each variable is assigned eight bytes, you could find the 
values for each variable by: 

1000 WTP = PEEK(134) + PEEK(135) * 256: Input VAR: REM VARIABLE NUMBER 
1010 For Loop = 0 To 7: Print PEEK(WTP + Loop + 8 * VAR): Next Loop 

where VAR is the variable number from zero to 127. 

If you wish to assign the same value to every element in a DIMed 
string variable use this simple technique: 

10 Dim TEST$(100) 

20 TEST$ = "*": REM Or use TEST$(1) 

30 TEST$(100) = TEST$ 

40 TEST$(2) = TEST$: Print TEST$ 

By assigning the first, last and second variables in the array in 
that order, your Atari will then assign the same value to the rest of 
the array. Make sure you make the second and last elements 
equal to the string, not the character value (i.e don't use 
TEXT$(2) = "*"). 

See De Re Atari for an example of SAVEing the six-byte BCD 
numbers to a disk file -- very useful when dealing with fixed 
record lengths. 

136,137 88,89 STMTAB 

The address of the Statement table (which is the beginning of the 
user’s BASIC program), containing all the tokenized lines of 
code plus the immediate mode lines entered by the user. Line 
numbers are stored as two-byte integers, and immediate mode 
lines are given the default value of line 32768 ($8000). The first 
two bytes of a tokenized line are the line number, and the next is 
a dummy byte reserved for the byte count (or offset) from the Start 
of this line to the Start of the next line. 
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Following that is another count byte for the Start of this line to the 
Start of the next Statement. These count values are set only when 
tokenization for the line and Statement are complete. 

Tokenization takes place in a 256 byte ($100) buffer that resides at 
the end of the reserved OS RAM (pointed to by locations 128, 

129; $80, $81). 

To see the starting address of your BASIC line numbers use this 
routine: 

10 STMTAB = PEEK(136) + PEEK(137)*256 
20 NUM = PEEK(STMTAB) + PEEK (STMTAB+1)*256 
30 If NUM = 32768 Then End 

40 Print "LINE NUMBER: ”;NUM;" ADDRESS: STMTAB 

50 STMTAB = STMTAB + PEEK(STMTAB+2) 

60 GoTo 20 

The August 1982 issue of ANTIC provided a useful program to 
delete a ränge of BASIC line numbers. The routine can be 
appended to your program and even be used to delete itself. 

138,139 8A,8B STMCUR 

Current BASIC Statement pointer, used to access the tokens 
being currently processed within a line of the Statement table. 

When BASIC is awaiting input, this pointer is set to the 
beginning of the immediate mode (line 32768). 

Using the address of the variable name table, the length, and the 
current Statement (locations 130 to 133, 138, 139), here is a way to 
protect your programs from being LISTed or LOADed: they can 
only be RUN! Remember, that restricts you too, so make sure you 
have SAVEd an unchanqed Version betöre you do this: 

32000 For VARI = PEEK(130) + PEEK(131) * 256 To PEEK(132) + 

PEEK(133) * 256:POKE VARI,155: Next VARI 
32100 POKE PEEK(138) + PEEK(139) *256 + 2,0: SAVE "D:filename": NEW 

This will cause all variable names to be replaced with a RETURN 
character. Other characters may be used: simply change 155 for 
the appropriate ATASCII code for the character desired. Make 
sure that these are the last two lines of your program and that 
NEW is the last Statement. CLOAD will not work, but a filename 
with C: will. 


140,141 8C,8D STARP 

The address for the string and array table and a pointer to the end 
of your BASIC program. Arrays are stored as six-byte binary 
coded decimal numbers (BCD) while string characters use one 
bye each. The address of the strings in the table are the same as 
those returned by the BASIC ADR function. Always use this 
function under program control, since the addresses in the table 
change according to your program size. Try: 


B$ 


10 Dim A$(10),B$(10) 

20 A$ = "*": A$(10) = A$: A$(2) = A$ 

30 B$ = B$(10) = B$: B$(2) = B$ 

40 Print ADR(A$), ADR(B$) 

50 Print PEEK(140) + PEEK(141) * 256: REM ADDRESS OF A$ 

60 Print PEEK(140) + PEEK(141) * 256 + 10: REM ADRESS OF A$ + 10 ByteS = ADDRESS OF 


This table is expanded as each dimension is processed by 
BASIC, reducing available memory. A ten-element numeric 
array will require 60 bytes for storage. An array variable such as 
DIM A(100) will cost the program 600 bytes (100 * six per 
dimensioned number equals 600). On the other hand, a string 
array such as DIM A$(100) will only cost 100 bytes! It would save 
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a lot of memory to write your arrays as strings and retrieve the 
array values using the VAL Statement. For example: 

10 Dim A$(10): A$ = "1234567890" 

20 Print VAL(A$) 

30 Print VAL(A$(4,4)) 

40 Print VAL(A$(3,3))+VAL(A$(8,9)) 

See COMPUTE!, June 1982, for a discussion of STARP and 
VVTP. See De Re Atari for a means to SAVE the string/array area 
with your program. 

142,143 8E,8F RUNSTK 

Address of the runtime stack which holds the GOSUB entries 
(four bytes each) and the FOR-NEXT entries (16 bytes each). The 
POP command in BASIC affects this stack, pulling entries off it 
one at a time for each POP executed. The stack expands and 
contracts as necessary while the program is running. 

Each GOSUB entry consists of four bytes in this Order: a zero to 
indicate a GOSUB, a two-byte integer line number on which the 
call occurred, and an offset into that line so the RETURN can 
come back and execute the next Statement. 

Each FOR-NEXT entry contains 16 bytes in this Order: first, the 
limit the counter variable can reach; second, the Step or counter 
increment. These two are allocated six bytes each in BCD format 
(12 bytes total). The 13th byte is the counter variable number with 
the MSB set; the 14th and 15th are the line number and the 16th is 
the line offset to the FOR Statement. 

RUNSTK is also called ENDSTAR; it is used by BASIC to point to 
the end of the string/array space pointed to by STARR above. 

144,145 90,91 MEMTOP 

Pointer to the top of BASIC memory, the end of the space the 
program takes up. There may still be space between this address 
and the display list, the size of which may be retrieved by the 
FRE(0) command (which actually subtracts the MEMTOP value 
that is at locations 741 and 742; $2E5, $2E6). Not to be confused 
with locations 741 and 742, which have the same name but are an 
OS variable. MEMTOP is also called TOPSTK; it points to the top 
of the stack space pointed to by RUNSTK above. 

When reserving memory using location 106 ($6A) and MEMTOP, 
here's a short error-trapping routine you can add: 

10 SIZE = (PEEK(106) - # of pages you are reserving) * 256 

20 If SIZE < = PEEK(144) + PEEK(145) * 256 Then Print " PROGRAM TOO LARGE 

Locations 146 to 202 ($92 to $CA) are reserved for use by the 8K 
BASIC ROM. 

Locations 176 to 207 ($B0 to $CF) are reserved by the Assembler 
Editor cartridge for the user's page zero use. The Assembler debug 
routine also reserves 30 bytes in page zero, scattered from location 164 
($A4) to 255 ($FF), but they cannot be used outside the debug process. 

(See De Re Atari, Rev. 1, Appendix A for a list of these available 
bytes.) 

186,187 BA,BB STOPLN 

The line where a program was stopped either due to an error or 
the use of the BREAK key, or a STOP or a TRAP Statement 
occurred. You can use PEEK (186) + PEEK (187) * 256 in a 
GOTO or GOSUB Statement. 


End 
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195 C3 ERRSAVE 

The number of the error code that caused the stop or the TRAP. 

You can use this location in a program in a line such as: 

10 IF PEEK(195) <> 144THEN 100 

201 C9 PTABW 

This location specifies the number of columns between TAB 
stops. The first tab will beat PEEK(201). The default is ten. This is 
the value between items separated in a PRINT Statement by com- 
mas - such as PRINT AS, LOOP, C(12) - not by the TAB key 
spacing. 

The minimum number of spaces between TABS is three. If you 
POKE 201,2, it will be treated as four spaces, and POKE 201,1 is 
treated as three spaces. POKE 201,0 will cause the System to 
hang when it encounters a PRINT Statement with commas. To 
change the TAB key settings, see TABMAP (locations 675 to 689; 

$2A3 - $2B1). PTABW is not reset to the default value by pressing 
RESET or changing GRAPHICS modes (unlike TABMAP). 

PTABW works in all GRAPHICS modes, not merely in text 
modes. The size of the spaces between items depends on the pixel 
size in the GRAPHICS mode in use. For example, in GR.0, each 
space is one character wide, while in GR.8 each space is one-half 
color clock (one dot) wide. 

203-207 CB-CF 

Unused by either the BASIC or the Assembler cartridges. 

208-209 D0-D1 

Unused by BASIC. The only time I have seen any of these unused 
locations in use is in COMPUTE! (March 1982 and October 
1981), when they were used for user sort routines, and in ANTIC 
(June 1982), where they were used as flags in a graphic 
demonstration. The bytes from 203 to 209 ($CB to $D1) are the 
only page zero bytes uncontestably left free by BASIC. 

210-211 D2-D3 

Reserved for BASIC or other cartridge use. 

Locations 212 to 255 ($D4 to $FF) are reserved for the floating point package use. The FP routines 
are in ROM, from locations 55296 to 57393 ($D800 to $E031). These page zero locations may be 
used if the FP package is not called by the user's program. However, do not use any of these 
locations for an interrupt routine, since such routines might occur during an FP routine called by 
BASIC, causing the System to crash. 

Floating Point uses a six-byte precision. The first byte of the Binary Coded Decimal (BCD) number 
is the exponent (where if BIT 7 equals zero, then the number is positive; if one, then it is negative). 
The next five bytes are the mantissa. If only that were all there was to it. The BCD format is rather 
complex and is best explained in chapter eight of De Re Atari. 

212-217 D4-D9 FR0 

Floating point register zero; holds a six-byte internal form of the 
FP number. The value at locations 212 and 213 are used to return 
a two-byte hexadecimal value in the ränge of zero to 65536 
($FFFF) to the BASIC program (low byte in 212, high byte in 
213). The floating point package, if used, requires all locations 
from 212 to 255. All six bytes of FR0 can be used by a machine 
language routine, provided FR0 isn't used and no FP functions 
are used by that routine. To use 16 bit values in FP, you would 
place the two bytes of the number into the least two bytes of FR0 
(212, 213; $D4, $D5), and then do a JSR to $D9AA (55722), which 
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will convert the integer to its FP representation, leaving the result 
in FRO. To reverse this Operation, do a JSR to $D9D2 (55762). 

218-223 DA-DF FRE 

FP extra register (?) 

224-229 E0-E5 FR1 

Floating point register one; holds a six-byte internal form of the 
FP number as does FRO. The FP package frequently transfers 
data between these two registers and uses both for two-number 
arithmetic operations. 

230-235 E6-EB FR2 

FP register two. 

236 EC FRX 

FP spare register. 

237 ED EEXP 

The value of E (the exponent). 

238 EE NSIGN 

The sign of the FP number. 

239 EF ESIGN 

The sign of the exponent. 

240 F0 FCHRFLG 

The first character flag. 

241 Fl DIGRT 

The number of digits to the right of the decimal. 

242 F2 CIX 

Character (current input) index. Used as an offset to the input 
text buffer pointed to by INBUFF below. 

243,244 F3,F4 INBUFF 

Input ASCII text buffer pointer; the user's program line input 
buffer, used in the translation of ATASCII code to FP values. The 
result output buffer is at locations 1408 to 1535 ($580 to $5FF). 

245,246 F5,F6 ZTEMP1 

Temporary register. 

247,248 F7,F8 ZTEMP4 

Temporary register. 

249,250 F9,FA ZTEMP3 

Temporary register. 

251 FB RADFLG 

Also called DEGFLG. When set to zero, all of the trigonometric 
functions are performed in radians; when set to six, they are done 
in degrees. BASIC's NEW command and RESET both restore 
RADFLG to radians. 

252,253 FC,FD FLPTR 

Points to the user's FP number. 

254,255 FE,FF FPTR2 
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Pointer to the user's second FP number to be used in an 
Operation. 

End of the page zero RAM. 


4.2 Page 1 

PAGE ONE: THE STACK 

Locations 256 to 511 ($100 to $1 FF) are the stack area for the OS, DOS and BASIC. This area is 
page one. Machine language JSR, PHA and interrupts all cause data to be written to page one, 
and RTS, PLA and RTI instructions all read data from page one. On powerup or RESET, the stack 
pointer is initialized to point to location 511 ($1 FF). The stack then pushes downward with each 
entry to 256 ($100). In case of overflow, the stack will wrap around from 256 back to 511 again. 


4 . 2.1 256-511 

Locations 256 to 511 ($100 to $1 FF) are the stack area for the OS, DOS and BASIC. This area is 
page one. Machine language JSR, PHA and interrupts all cause data to be written to page one, 
and RTS, PLA and RTI instructions all read data from page one. On powerup or RESET, the stack 
pointer is initialized to point to location 511 ($1 FF). The stack then pushes downward with each 
entry to 256 ($100). In case of overflow, the stack will wrap around from 256 back to 511 again. 


4.3 Page 2 

Locations 512 to 1151 ($200 to $47F) are used by the OS for working variables, tables and data 
buffers. In this area, locations 512 to 553 ($200 to $229) are used for interrupt vectors, and 
locations 554 to 623 ($22A to $26F) are for miscellaneous use. Much of pages two through five 
cannot be used except by the OS unless specifically noted. A number of bytes are marked as 
"spare", i.e., not in use currently. The Status of these bytes may change with an Atari Upgrade, so 
their use is not recommended. 

There are two types of interrupts: Non-Maskable Interrupts (NMI) processed by the ANTIC Chip 
and Interrupt Requests (IRQ) processed by the POKEY and the PIA Chips. NMI's are for the 
VBLANK interrupts (VBI's; 546 to 549, $222 to $225), display list interrupts (DLI) and RESET key 
interrupts. They initiate the stage one and stage two VBLANK procedures; usually vectored through 
an OS Service routine, they can be vectored to point to a user routine. IRQ's are for the timer 
interrupts, peripheral and serial bus interrupts, BREAK and other key interrupts, and 6502 BRK 
instruction interrupts. They can usually be used to vector to user routines. See NMIST 54287 
($D40F) and IRQEN 53774 ($D20E) for more Information. NMI interrupt vectors are marked NMI; 
IRQ interrupt vectors are marked IRQ. Refer to the chart below location 534 for a list of the 
interrupt vectors in the new OS "B" Version ROMs. 


4 . 3.1 512-535 

512,513 200,201 VDSLST 

The vector for NMI Display List Interrupts (DLI): containing the 
address of the instructions to be executed during a DLI (DLl's are 
used to interrupt the processor flow for a few microseconds at the 
particular screen display line where the bit was set, allowing you 
to do another short routine such as music, changing graphics 
modes, etc.). The OS doesn't use DLl’s; they must be user- 
enabled, written and vectored through here. The NMI Status 
register at 54287 ($D40F) first tests to see if an interrupt was 
caused by a DLI and, if so, jumps through VDSLST to the routine 
written by the user. DLl’s are disabled on powerup, but VBI's are 
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enabled (see 546 to 549; $222 to $225). 

VDSLST is initialized to point to 59315 ($E7B3), which is merely 
an RTI instruction. To enable DLl's, you must first POKE 54286 
($D40E) with 192 ($C0); otherwise, ANTIC will ignore your 
request. You then POKE 512 and 513 with the address (LSB/MSB) 
of the first assembly language routine to execute during the DU. 
You must then set BIT 7 of the Display List instruction(s) where 
the DU is to occur. You have only between 14 and 61 machine 
cycles available for your DU, depending on your GRAPHICS 
mode. You must first push any 6502 registers onto the stack, and 
you must end your DU with an RTI instruction. Because you are 
dealing with machine language for your DU, you can POKE 
directly into the hardware registers you plan to change, rather 
than using the shadow registers that BASIC uses. 

There is, unfortunately, only one DU vector address. If you use 
more than one DU and they are to perform different activities, 
then changing the vectoring to point to a different routine must 
be done by the previous DLl's themselves. 

Another way to accomplish interrupts is during the VBLANK 
interval with a VBI. One small problem with using DLl's is that 
the keyboard "click" routine interferes with the DLI by throwing 
off the timing, since the click is provided by several calls to the 
WSYNC register at 54282 ($D40A). Chris Crawford discusses 
several Solutions in De Re Atari, but the easiest of them is not to 
allow input from the keyboard! See Micro, December 1981, 
Creative Computing, July 1981 and December 1981. 

Here's a short example of a DLI. It will print the lower half of your 
text screen upside down: 

10 START = PEEK(560) + PEEK(561) * 

256: POKE START + 16,130 

20 PAGE = 1536: For PGM = PAGE To P 
AGE + 7: Read Byte: POKE PGM, Byte 
: Next PGM 

30 DATA 72,169,4,141,1,212,104,64 

40 POKE 512,0: POKE 513,6: POKE 542 
86,192 

50 For TEST = 1 To 240: Print"SEE " 

;: Next TEST 

60 GoTo 60 

Another example of a DLI changes the color of the bottom half of 
the screen. To use it, simply change the PAGE + 7 to PAGE + 10 
in the program above and replace line 30 with: 

30 DATA 72,169,222,141,10,212,141,2 
4,208,104,64 

Finally, delete lines 50 and 60. See also location 54282 ($D40A). 

514,515 202,203 VPRCED 

Serial (peripheral) proceed line vector, initialized to 59314 
($E7B2), which is merely a PLA, RTI instruction sequence. It is 
used when an IRQ interrupt occurs due to the serial I/O bus 
proceed line which is available for peripheral use. According to 
De Re Atari, this interrupt is not used and points to a PLA, RTI 
instruction sequence. This interrupt is handled by the PIA Chip 
and can be used to provide more control over external devices. 
See the OS Listing, page 33. 

516,517 204,205 VINTER 

Serial (peripheral) interrupt vector, initialized to 59314 ($E7B2). 
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Used for the IRQ interrupt due to a serial bus I/O interrupt. 
According to De Re Atari, this interrupt is not used and points to 
a PLA, RTI sequence. This interrupt is processed by PIA. See the 
OS Listing, page 33. 

518,519 206,207 VBREAK 

Software break instruction vector for the 6502 BRK ($00) 
command (not the BREAK key, which is at location 17; $11), 
initialized to 59314 ($E7B2). This vector is normally used for 
setting break points in an assembly language debug Operation. 
IRQ. 

520,521 208,209 VKEYBD 

POKEY keyboard interrupt vector, used for an interrupt 
generated when any keyboard key is pressed other than BREAK 
or the console buttons. Console buttons never generate an 
interrupt unless one is specifically user-written. VKEYBD can be 
used to process the key code betöre it undergoes conversion to 
ATASCII form. Initialized to 65470 ($FFBE) which is the OS 
keyboard IRQ routine. 

522,523 20A,20B VSERIN 

POKEY serial I/O bus receive data ready interrupt vector, 
initialized to 60177 ($EB11), which is the OS code to place a byte 
from the serial input port into a butter. Called INTRVEC by DOS, 
it is used as an interrupt vector location for an SIO patch. DOS 
changes this vector to 6691 ($1A23), the Start of the DOS 
interrupt ready Service routine. IRQ. 

524,525 20C,20D VSEROR 

POKEY serial I/O transmit ready interrupt vector, initialized to 
60048 (EA90), which is the OS code to provide the next byte in a 
butter to the serial output port. DOS changes this vector to 6630 
($19E6), the Start of the DOS output needed interrupt routine. 

IRQ. 

526,527 20E,20F VSEROC 

POKEY serial bus transmit complete interrupt vector, initialized 
to 60113 ($EAD1), which sets a transmission done flag after the 
checksum byte is sent. IRQ. 

SIO uses the three last interrupts to control serial bus 
communication with the serial bus devices. Düring serial bus 
communication, all program execution is halted. The actual 
serial I/O is interrupt driven; POKEY waits and watches for a flag 
to be set when the requested I/O Operation is completed. Düring 
this wait, POKEY is sending or receiving bits along the seriai 
bus. When the entire byte has been transmitted (or received), the 
output needed (VSEROR) or the input ready (VSERIN) IRQ is 
generated according to the direction of the data flow. This causes 
the next byte to be processed until the entire buffer has been sent 
or is full, and a flag for "transmission done" is set. At this point, 
SIO exits back to the calling routine. You can see that SIO wastes 
time waiting for POKEY to send or receive the Information on the 
bus. 

528,529 210,211 VTIMR1 

POKEY timer one interrupt vector, initialized to 59314 ($E7B2), 
which is a PLA, RTI instruction sequence. Timer interrupts are 
established when the POKEY timer AUDF1 (53760; $D200) 
counts down to zero. Values in the AUDF registers are loaded 
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into STIMER at 53769 ($D209). IRQ. 

530,531 212,213 VTIMR2 

POKEY timer two vector for AUDF2 (53762, $D202), initialized to 
59314 ($E7B2). IRQ. 

532,533 214,215 VTIMR4 

POKEY timer four vector for AUDF4 (53766, $D206), initialized 
to 59314 ($E7B2). This IRQ is only vectored in the "B" Version of 
the OS ROMs. 

534,535 216,217 VIMIRQ 

The IRQ immediate vector (general). Initialized to 59126 
($E6F6). JMP through here to determine cause of the IRQ 
interrupt. Note that with the new ("B") OS ROMs, there is a 
BREAK key interrupt vector at locations 566, 567 ($236, $237). 
See 53774 ($D20E) for more information on IRQ interrupts. 

The new "B" Version OS ROMs change the vectors above as 
follows: 


VDSLST 

59280 

($E7 90) 

VPRCED 

59279 

($E78F) 

VINTER 

59279 

($E78F) 

VBREAK 

59279 

($E78F) 

VKEYBD 

NO CHANGE 

VSERIN 

60175 

($EB0F) 

VSEROR 

NO CHANGE 

VSEROC 

60111 

($EACF) 

VTIMR 1-4 

59279 

($E78F) 

VIMIRQ 

59142 

($E70 6) 

WBLKI 

59310 

($E7AE) 

WBLKD 

59653 

($E905) 


4 . 3.2 536 - 558 


The locations from 536 to 558 ($218 to $22E) are used for the System Software timers. Hardware 
timers are located in the POKEY Chip and use the AUDF registers. These timers count backwards 
every 1/60 second (stage one VBLANK) or 1/30 second (stage two VBLANK) interval until they 
reach zero. If the VBLANK process is disabled or intercepted, the timers will not be updated. See 
De Re Atari for information regarding setting these timers in an assembly routine using the 
SETVBV register (58460; $E45C). These locations are useraccessible and can be made to count 
time for music duration, game I/O, game clock and other functions. Software timers are used for 
durations greater than one VBLANK interval (1/60 second). For periods of shorter duration, use the 
hardware registers. 

DECIMAL HEX LABEL 

536,537 218,219 CDTMV1 

System timer one value. Counts backwards from 255. This SIO 
timer is decremented every stage one VBLANK. When it reaches 
zero, it sets a flag to jump (JSR) through the address stored in 
locations 550, 551 ($226, $227). Only the realtime clock 
(locations 18-20; $12-14), timer one, and the attract mode 
register (77; $4D) are updated when the VBLANK routine is cut 
short because time-critical code (location 66; $42 set to non-zero 
for critical code) is executed by the OS. Since the OS uses timer 
one for its I/O routines and for timing serial bus operations 
(setting it to different values for timeout routines), you should use 
another timer to avoid conflicts or interference with the Operation 
of the System. 

538,539 21A.21B CDTMV2 

System timer two. Decremented at the stage two VBLANK. Can 
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be decremented every stage one VBLANK, subject to critical 
section test as defined by setting of CRITIC flag (location 66; 

$42). This timer may miss (skip) a count when time-critical code 
(CRITIC equals non-zero) is being executed. It performs a JSR 
through location 552, 553 ($228, $229) when the value counts 
down to zero. 

540,541 21 C,21 D CDTMV3 

System timer three. Same as 538. Timers three, tour, and five are 
stopped when the OS sets the CRITIC flag to non-zero as well. 

The OS uses timer three to OPEN the cassette recorder and to set 
the length of time to read and write tape headers. Any prior value 
in the register during this function will be lost. 

542,543 21 E,21 F CDTMV4 

System timer tour. Same as 538 ($21A). 

544,545 220,221 CDTMV5 

System timer five. Same as 538 ($21A). Timers three, tour, and 
five all set flags at 554, 556 and 558 ($22A, $22C, $22E), 
respectively, when they decrement to zero. 

546,547 222,223 VVBLKI 

VBLANK immediate register. Normally jumps to the stage one 
VBLANK vector NMI Interrupt processor at location 59345 
($E7D1); in the new OS "B" ROMs; 59310, $E7AE). The NMI 
Status register tests to see if the interrupt was due to a VBI (after 
testing for a DLI) and, if so, vectors through here to the VBI 
routine, which may be user-written. On powerup, VBI's are 
enabled and DLl's are disabled. See location 512; $200. 

548,549 224,225 VVBLKD 

VBLANK deferred register; System return from interrupt, 
initialized to 59710 ($E93E, in the new OS "B" ROMs; 59653; 
$E905), the exit for the VBLANK routine. NMI. 

These two VBLANK vectors point to interrupt routines that occur 
at the beginning of the VBLANK time interval. The stage one 
VBLANK routine is executed; then location 66 ($42) is tested for 
the time-critical nature of the interrupt and, if a critical code 
section has been interrupted, the stage two VBLANK routine is 
not executed with a JMP made through the immediate vector 
VVBLKI. If not critical, the deferred interrupt VVBLKD is used. 
Normally the VBLANK interrupt bits are enabled (BIT 6 at 
location 54286; $D40E is set to one). To disable them, clear BIT 6 
(set to zero). 

The normal seguence for VBLANK interrupt events is: after the 
OS test, JMP to the user immediate VBLANK interrupt routine 
through the vector at 546, 547 (above), then through SYSVBV at 
58463 ($E45F). This is directed by the OS through the VBLANK 
interrupt Service routine at 59345 ($E7D1) and then on to the 
user-deferred VBLANK interrupt routine vectored at 548, 549. it 
then exits the VBLANK interrupt routine through 58466 ($E462) 
and an RTI instruction. 

If you are changing the VBLANK vectors during the interrupt 
routine, use the SETVBV routine at 58460 ($E45C). An 
immediate VBI has about 3800 machine cycles of time to use a 
deferred VBI has about 20,000 cycles. Since many of these cycles 
are executed while the electron beam is being drawn, it is 
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suggested that you do not execute graphics routines in deferred 
VBI's. See the table of VBLANK processes at the end of the map 
area. 

if you create your own VBI's, terminate an immediate VBI with a 
JMP to 58463 ($E45F) and a deferred VBI with a JMP to 58466 
($E462). To bypass the OS VBI routine at 59345 ($E7D1) entirely, 
terminate your immediate VBI with a JMP to 58466 ($E462). 

Here's an example of using a VBI to create a flashing Cursor. It 
will also blink any text you display in inverse mode. 

10 For BLINK = 1664 To 1680: Read BYTE: POKE BLINK, Byte: Next BLINK 
20 POKE 548,128: POKE 549,6 
30 DATA 8,72,165,20, 41,16, 74,74,74,141 
40 DATA 243,2,104,40,76,62,233 

To restore the normal Cursor and display, POKE 548,62 and 
POKE 549,233. 

550,551 226,227 CDTMA1 

System timer one jump address, initialized to 60400 ($EBF0). 

When locations 536, 537 ($218, $219) reach (Countdown to) zero, 
the OS vectors through here (jumps to the location specified by 
these two addresses). You can set your machine code routine 
address here for execution when timer one reaches (counts down 
to) zero. Your code should end with the RTS instruction. 

Problems may occur when timer values are set greater than 255, 
since the 6502 cannot manipulate 16-bit values directly (a 
number in the ränge of zero to 255 is an eight-bit value; if a value 
requires two bytes to störe, such as a memory location, it is a 
16-bit value). Technically, a VBLANK interrupt could occur 
when one timer byte is being initialized and the other not yet set. 

To avoid this, keep timer values less than 255. See the Atari OS 
User's Manual, page 106, for details. 

Since the OS uses timer one, it is recommended that you use 
timer two instead, to avoid conflicts with the Operation of the 
Atari. Initialized to 60396 ($EBEA) in the old ROMs, 60400 
($EBF0) in the new ROMs. NMI 

552,553 228,229 CDTMA2 

System timer two jump address. Not used by the OS, available to 
user to enter the address of his or her own routine to JMP to when 
the timer two (538, 539; $21A, $21B) count reaches zero. 

Initialized to zero; the address must be user specified. NMI 

554 22A CDTMF3 

System timer three flag, set when location 540, 541 ($21C, $21D) 
reaches zero. This register is also used by DOS as a timeout flag. 

555 22B SRTIMR 

Software repeat timer, controlled by the IRQ device routine. It 
establishes the initial 1/2 second delay betöre a key will repeat. 

Stage two VBLANK establishes the 1/10 second repeat rate, 
decrements the timer and implements the auto repeat logic. 

Every time a key is pressed, STIMER is set to 48 ($30). Whenever 
SRTIMR is equal to zero and a key is being continuously pressed, 
the value of that key is continually stored in CH, location 764 
($2FC). 

556 22C CDTMF4 

System timer tour flag. Set when location 542, 543 ($21E, $21F) 
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counts down to zero. 

557 22D INTEMP 

Temporary register used by the SETVBL routine at 58460 
($E45C). 

558 22E CDTMF5 

System timer five flag. Set when location 558, 559 ($22E, $22F) 
counts down to zero. 


4 . 3.3 559 - 623 

DECIMAL HEX LABEL 

559 22F SDMCTL 

Direct Memory Access (DMA) enable. POKEing with zero allows 
you to turn off ANTIC and speed up Processing by 30%. Of 
course, it also means the screen goes blank when ANTIC is 
turned off! This is useful to speed things up when you are doing a 
calculation that would take a long time. It is also handy to turn off 
the screen when loading a drawing, then turning it on when the 
screen is loaded so that it appears instantly, complete on the 
screen. To use it you must first PEEK(559) and save the result in 
Order to return your screen to you. Then POKE 559,0 to turn off 
ANTIC. When you are ready to bring the screen back to life, 
POKE 559 with the number saved earlier. 

This location is the shadow register for 54272 ($D400), and the 
number you PEEKed above defines the playfield size, whether or 
not the missiles and players are enabled, and the player size 
resolution. To enable your options by using POKE 559, simply 
add up the values below to obtain the correct number to POKE 
into SDMCTL. Note that you must choose only one of the four 
playfield options appearing at the beginning of the list: 


Option 

Decimal 

Bit 

No playfield 

0 

0 

Narrow playfield 

1 

0 

Standard playfield 

2 

0, 1 

Wide playfield 

3 

0, 1 

Enable missle DMA 

4 

2 

Enable player DMA 

Enable player And missile 

8 

3 

DMA 

12 

2,3 

One Line player resolution 
Enable instructions To fetch 

16 

4 

DMA 

32 

5 (see below) 


Note that two-line player resolution is the default and that it is not 
necessary to add a value to 559 to obtain it. I have included the 
appropriate bits affected in the table above. The default is 34 
($ 22 ). 

The playfield is the area of the TV screen you will use for display, 
text, and graphics. Narrow playfield is 128 color clocks (32 
characters wide in GR.O), Standard playfield is 160 color clocks 
(40 characters), and wide playfield is 192 color clocks wide (48 
characters). A color clock is a physical measure of horizontal 
distance on the TV screen. There are a total of 228 color clocks on 
a line, but only some of these (usually 176 maximum) will be 
visible due to screen limitations. A pixel, on the other hand, is a 
logical unit which varies in size with the GRAPHICS mode. Due 
to the limitations of most TV sets, you will not be able to see all of 
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the wide playfield unless you scroll into the offscreen portions. 

BIT 5 must be set to enable ANTIC Operation; it enables DMA for 
fetching the display list instructions. 

560,561 230,231 SDLSTL 

Starting address of the display list. The display list is an 
instruction set to teil ANTIC where the screen data is and how to 
display it. These locations are the shadow for 54274 and 54275 
($D402, $D403). You can also find the address of the DL by 
PEEKing one byte above the top of free memory: 

Print PEEK (741) + PEEK(742) * 256 + 1. 

However, 560 and 561 are more reliable pointers since custom 
DL's can be elsewhere in memory. Atari Standard display lists 
simply instruct the ANTIC Chip as to which types of mode lines to 
use for a screen and where the screen data may be found in 
memory. Normally, a DL is between 24 and 256 bytes long (most 
are less than 100 bytes, however), depending on your 
GRAPHICS mode (see location 88,89 for a chart of DL sizes and 
screen display use). 

By altering the DL, you can mix graphics modes on the same 
screen; enable fine scrolling; change the location of the screen 
data; and force interrupts (DLl’s) in order to perform short 
machine language routines. 

DL bytes five and six are the addresses of the screen memory 
data, the same as in locations 88 and 89 ($58, $59). Bytes four, 
five, and six are the first Load Memory Scan (LMS) instruction. 

Byte four teils ANTIC what mode to use; the next two bytes are 
the location of the first byte of the screen RAM (LSB/MSB). 

Knowing this location allows you to write directly to the screen by 
using POKE commands (you POKE the internal character codes, 
not the ATASCII codes - see the BASIC Reference Manual, p. 

55). 

For example, the program below will POKE the internal codes to 
the various screen modes. You can see not only how each screen 
mode handles the codes, but also roughly where the text window 
is in relation to the display screen (the 160 bytes below 
RAMTOP). Note that the GTIA modes have no text window. If 
you don't have the GTIA Chip, your Atari will default to 
GRAPHICS 8, but with GTIA formatting. 

1 TRAP 10: GRAPHICS Z 

5 SCREEN = PEEK(560) + PEEK(561) * 256 

6 TV = SCREEN + 4: TELE = SCREEN + 5 

8 DISPLAY = PEEK(TV) + PEEK(TELE) * 256 
10 For N = 0 To 255: POKE DISPLAY +N,N: Next N 
20 DISPLAY = DISPLAY + N 

30 If DISPLAY > 40959 Then Z = Z + 1: GoTo 1 
40 GoTo 10 

50 Z = Z + l:If Z > 60 Then End 
60 GoTo 1 

Here’s another short program which will allow you to examine the 
DL in any GRAPHICS mode: 

10 REM CLEAR SCREEN FIRST 

20 Print "ENTER GRAPHICS MODE": REM ADD 16 To THE MODE To SUPPRESS THE Text WINDOW 
30 Input A: GRAPHICS A 

40 DLIST = PEEK(560) + PEEIK(561) * 256 
50 LOOK = PEEK(DLIST): Print LOOK;""; 

60 If LOOK <> 65 Then DLIST = DLIST+ 1: GoTo 50 
70 LPRINT PEEK(DLIST + 1);" ";PEEK(DLIST + 2) 
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80 End 

The value 65 in the DL is the last instruction encountered. It teils 
ANTIC to jump to the address in the next two bytes to re-execute 
the DL, and wait for the next VBLANK. If you don't have a 
printer, change the LPRINT commands to PRINT and modify the 
routine to save the data in an array and PRINT it to the screen 
after (in GR.O). 

If you would like to examine the locations of the Start of the 
Display List, screen, and text window, try: 


5 REM CLEAR SCREEN FIRST 

6 Input A: GRAPHICS A 

10 Dim DLIST$(10), SAVMSC$(10), TXT$(10) 

15 DLIST$ = "DLIST": SAVMSC$ = "SAVMSC": TXT$ = "TEXT" 

20 DLIST = PEEK(560) + PEEK(561) * 256 

30 SAV = PEEK (88) + PEEK(89) * 256:TXT = PEEK(660) + PEEK(661) * 256 
40 Print DLIST$;" DLIST,SAVMSC$SAV 
50 Print TXT$;" Text 
60 Input A: GRAPHICS A: GoTo 20 


Since an LMS is simply a map mode (graphics) or character 
mode (text) instruction with BIT six set, you can make any or all of 
these instructions into LMS instructions quite easily, pointing 
each line to a different RAM area if necessary. This is discussed 
in De Re Atari on implementing horizontal scrolling. 

DL's can be used to help generate some of the ANTIC screen 
modes that aren't supported by BASIC, such as 7.5 (ANTIC 
mode E) or ANTIC mode three, the lowercase with descenders 
mode (very interesting; ten scan lines in height which allow true 
descenders on lowercase letters). 

If you create your own custom DL, you POKE its address here. 
Hitting BESET or changing GRAPHICS modes will restore the 
OS DL address, however. The display list instruction is loaded 
into a special register called the Display Instruction Register (IR), 
which processes the three DL instructions (blank, jump, or 
display). It cannot be accessed directly by the programmer in 
either BASIC or machine language. A DL cannot cross a 1K 
boundary unless ajump instruction is used. 


There are only four display list instructions: blank line (uses BAK 
color), map mode, text mode, and jump. Text (character mode) 
instructions and map mode (graphics) instructions ränge from 
two to 15 ($2 to $F) and are the same as the ANTIC GRAPHICS 
modes. A DL instruction byte uses the following conventions 
(functions are enabled when the bit is set to one): 


Bit 

7 

6 

5 

4 

3-0 


Decimal 

Function 



128 

Display 

List Interrupt 

when Set (enabled 


equals 

one) 



64 

Load Memory 

Scan. Next 

two bytes are the 


LSB/MSB 

of 

the data To 

load. 

32 

Enable ■ 

vertical fine scrolling. 

16 

Enable ' 

horizontal fine 

scrolling. 

8-1 

Mode 





0 0 1 

0 

Character 



To 


Modes 



0 11 

1 




10 0 

0 

Map 



To 


Modes 



111 

1 




The above bits may be combined (i.e., DLI, scrolling and LMS 
together) if the user wishes. 
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Special DL instructions (With decimal values): 


Blank 1 

Line 

= 0 

5 lines = 

64 

2 

lines 

= 16 

6 lines = 

80 

3 

lines 

= 32 

7 lines = 

96 

4 

lines 

= 48 

8 lines = 

112 


Jump instruction (JMP) = zero (three-byte instruction). 

Jump and wait for Vertical Blank (JVP) = 65 (three-byte 
instruction). 

Special instructions may be combined only with DL interrupt 
instructions. 


A Display List Interrupt is a special form of interrupt that takes 
place during the screen display when the ANTIC encounters a 
DL instruction with the interrupt BIT 7 set. See location 512 
($200) for DLI information. 

Since DL's are too large a topic to cover properly in this manual, 
I suggest you look in the many magazines (i.e., Creative 
Computing, July 1981, August 1981; Micro, December 1981; 
Softside, #30 to 32, and BYTE, December 1981) for a more 
detailed explanation 


562 232 SSKCTL 

Serial port control register, shadow for 53775 ($D20F). Setting 
the bits in this register to one has the following effect: 


Bit 

0 

1 

2 

3 

4-6 

7 


Decimal 

1 

2 

4 


16-64 

128 


Function 

Enable the keyboard debounce Circuit. 

Enable the keyboard scanning Circuit. 

The pot counter completes a Read within two 
scan lines instead of one frame time. 

Serial Output transmitted As two-tone instead 
of logic True/False (POKEY two-tone mode). 
Serial port mode control. 

Force break; serial Output To zero. 


Initialized to 19 ($13) which sets bits zero, one and four. 


563 233 SPARE 

No OS use. See the note at location 651 regarding spare bytes. 


564 234 LPENH 

Light pen horizontal value shadow for 54284 ($D40C). Values 
ränge from zero to 227. 


565 235 LPENV 

Light pen vertical value: shadow for 54285 ($D40D). Value is the 
same as VCOUNT register for two-line resolution (see 54283; 
$D40B). Both light pen values are modified when the trigger is 
pressed (pulled low). The light pen positions are not the same as 
the normal screen row and column positions. There are 96 
vertical positions, numbered from 16 at the top to 111 at the 
bottom, each one equivalent to a scan line. Horizontal positions 
are marked in color clocks. There are 228 horizontal positions, 
numbered from 67 at the left. When the LPENH value reaches 
255, it is reset to zero and begins counting again by one to the 
rightmost edge, which has a value of seven. 


Obviously, because of the number of positions readable and the 
small size of each, a certain leeway must be given by the 
programmer when using light pen readouts on a program. At the 
time of this writing, Atari had not yet released its light pen onto 
the market, although other Companies have. 
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566,567 236,237 BRKKY 

BREAK key interrupt vector. This vector is available only with 
the Version "B" OS ROMs, not the earlier Version. You can use 
this vector to write your own BREAK key interrupt routine. 

Initialized to 59220 ($E754). 

568,569 238,239 

Two spare bytes. 

570 23A CDEVIC 

Four-byte command frame butter (CFB) address for a device -- 
used by SIO while performing serial I/O, not for user access. 

CDEVIC is used for the SIO bus ID number The other three CFB 
bytes are: 

571 23B CCOMND 

The SIO bus command code. 

572 23C CAUX1 

Command auxiliary byte one, loaded from location 778 ($30A) 
by SIO. 

573 23D CAUX2 

Command auxiliary byte two, loaded from location 779 ($30B) by 
SIO. 

574 23E TEMP 

Temporary RAM register for SIO. 

575 23F ERRFLG 

SIO error flag; any device error except the timeout error (time 
equals zero). 

576 240 DFLAGS 

Disk flags read from the first byte of the boot file (sector one) of 
the disk. 

577 241 DBSECT 

The number of disk boot sectors read from the first disk record. 

578,579 242,243 BOOTAD 

The address for where the disk boot loader will be put. The 
record just read will be moved to the address specified here, 
followed by the remaining records to be read. Normally, with 
DOS, this address is 1792 ($700), the value also stored 
temporarily in RAMLO at 4, 5. Address 62189 ($F2ED) is the OS 
disk boot routine entry point (DOBOOT). 

580 244 COLDST 

Coldstart flag. Zero is normal, if zero, then pressing RESET will 
not result in reboot. If POKEd with one (powerup in progress 
flag), the Computer will reboot whenever the RESET key is 
pressed. Any non-zero number indicates the initial powerup 
routine is in progress. 

If you create an AUTORUN.SYS file, it should end with an RTS instruction. If not, it should POKE 
580 with zero and POKE 9 with one. You can turn any binary file that boots when loaded with DOS 
menu selection "L" into an auto-boot file simply by renaming it "AUTORUN.SYS". Be careful not to 
use the same name for any two files on the same disk. 

When this is combined with the disabling of the BREAK key discussed in location 16 ($10) and the 
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program protection scheme discussed in location 138 ($8A), you have the means to protect your 

BASIC Software fairly effectively from being LISTed or examined, although not from being copied. 

581 245 
Spare byte. 

582 246 DSKTIM 

Disk time-out register (the address of the OS worst case disk time- 
out). It is said by many sources to be set to 160 at initialization 
which represents a 171 second time-out, but my System shows a 
value of 224 on initialization. Timer values are 64 seconds for 
each 60 units of measurement expressed. 

It is updated after each disk Status request to contain the value of 
the third byte of the Status frame (location 748; $2EC). All disk 
operations have a seven second time-out (except FORMAT), 
established by the disk handler (you had noticed that irritating 
little delay, hadn't you?). The "sleeping disk syndrome" (the 
Printer suffers from this malady as well) happens when your drive 
times out, or the timer value reaches zero. This has been cured 
by the new OS "B" Version ROMs. 

583-622 247-26E LINBUF 

Forty-byte character line buffer, used to temporarily buffer one 
physical line of text when the screen editor is moving screen 
data. The pointer to this buffer is stored in 100, 101 ($64, $65) 
during the routine. 

623 26F GPRIOR 

Priority selection register, shadow for 53275 ($D01 B). Priority 
options select which screen objects will be "in front" of others. It 
also enables you to use all four missiles as a fifth player and 
allows certain overlapping players to have different colors in the 
areas of overlap. You add your options up as in location 559, 
prior to POKEing the total into 623. In this case, choose only one 
of the four priorities stated at the beginning. BAK is the 
background or border. You can also use this location to select 
one of GTIA GRAPHICS modes nine, ten, or eleven. 


Priority options In Order 


Decimal 

Bit 

Player 0-3, playfield 0-3, 
(background) 

BAK 

1 

0 

Player 0-1, playfield 0-3, 
BAK 

player 2-3, 

2 

1 

Playfield 0-3, player 0-3, 

BAK 

4 

2 

Playfield 0-1, player 0-3, 
BAK 

playfield 2 -3, 

8 

3 

Other options 

Four missiles = fifth player 


16 

4 

Overlaps of players have 3rd color 

32 

5 

GRAPHICS 9 (GTIA mode) 


64 

6 

GRAPHICS 10 (GTIA mode) 


128 

7 

GRAPHICS 11 (GTIA mode) 


192 

6, 


It is quite easy to set conflicting priorities for players and 
playfields. In such a case, areas where both overlap when a 
conflict occurs will turn black. The same happens if the overlap 
Option is not chosen. 

With the color/overlap enable, you can get a multicolor player 
by combining players. The Atari performs a logical OR to colors 
of players 0/1 and 2/3 when they overlap. Only the 0/1,2/3 
combinations are allowed; you will not get a third color when 
players 1 and 3 overlap, for example (you will get black instead). 
If player one is pink and player 0 is blue, the overlap is green. If 
you don't enable the overlap Option, the area of overlap for all 
players will be black. 
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In GTIA mode nine, you have 16 different luminances of the 
same hue. In BASIC, you would use SETCOLOR 4,HUE,0. To 


see an 

example of GTIA mode nine, try: 

10 

GRAPHICS 9: SETCOLOR 

4, 9, 0 

20 

For Loop = 1 To 

15 : 

COLOR Loop 

30 

For Line = 1 To 

2 


40 

For TEST = 1 To 

25: 

PLOT 4 + TEST, Loop + Line + SPACE: 

45 

Next Line 



50 

SPACE = SPACE + 

4 


60 

Next Loop 



70 

GoTo 70: REM WITHOUT 

THIS Line,SCREEN WILL Return To GR.O 


In GTIA mode ten, you have all nine color registers available; 
hue and luminance may be set separately for each (it would 
otherwise allow 16 colors, but there are only nine registers). Try 
this to see: 

10 N = 0: GRAPHICS 10 
20 For Q = 1 To 2 

30 For B = 0 To 8: POKE 704 + B, N* 16 + A 

35 If A > 15 Then A = 0 
40 COLOR B 

45 A = A+1:N = N + 1 

50 If N > 15 Then N = 0 

60 Next B 

65 TRAP 70: Next Q 

70 POP: N = N + 1: For Z = 1 To 200: Next Z 
75 GoTo 30 


GTIA mode eleven is similar to mode nine except that it allows 16 
different hues, all of the same luminance. In BASIC, use 
SETCOLOR 4,0,luminance. Try this for a GTIA mode eleven 
demonstration: 

10 GRAPHICS 11 

20 For Loop = 0 To 79: COLOR Loop:PLOT Loop,0: DRAWTO Loop,191: Next Loop 
30 GoTo 30 

You can use these examples with the routine to rotate colors, 
described in the text preceding location 704. GTIA mode pixels 
are long and skinny; they have a four to one horizontal length to 
height ratio. This obviously isn't very good for drawing curves 
and circles! 

GTIA modes are cleared on the OPEN command. How can you 
teil if you have the GTIA Chip? Try POKE 623,64. If you have the 
GTIA, the screen will go all black. If not, you don't have it. Here 
is a short routine, written by Craig Chamberlain and Sheldon 
Leemon for COMPUTER which allows an Atari to test itself for the 
presence of a CTIA or GTIA Chip. The routine flashes the answer 
on the screen, hut can easily be modified so a program will 
"know" which Chip is present so it can adapt itself accordingly: 

10 POKE 66,1:GRAPHICS 8:POKE 709,0:POKE 710,0:POKE 66,0: 

POKE 623,64:P0KE 53248,42:POKE 53261,3:PUT#6,1 
20 POKE 53278,0:For K=1 To 300:Next K:GRAPHICS 18:POKE 53248,0: 

POSITION 8,5:? #6;CHR$(71-PEEK(53252));"TIA" 

30 POKE 708,PEEK(20): GoTo 30 

How can you get the GTIA if you don't have one? Ask your local 
Atari Service representative or dealer, or write directly to Atari in 
Sunnyvale, California. 

See the GTIA/CTIA introduction at location 53248 ($D000) for 
more discussion of the Chip. See BYTE, May 1982, COMPUTEI, 

July through September 1982, and De Re Atari for more on the 
GTIA Chip, and the GTIA Demonstration Diskette from the Atari 
Program Exchange (APX). 
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4 . 3.4 624 - 647 

Locations 624 to 647 ($270 to $287) are used for game Controllers: paddle, joystick and lightpen 
values. 

DECIMAL HEX LABEL 


624 270 PADDLO 

The value of paddle 0 (paddles are also called pots, short for 
Potentiometer); PEEK 624 returns a number between zero and 
228 ($E4), increasing as the knob is turned counter-clockwise. 
When used to move a player or Cursor (i.e., PLOT 
PADDLE(0),0), test your screen first. Many sets will not display 
locations less than 48 ($30) or greater than 208 ($D0), and in 
many GRAPHICS modes you will get an ERROR 141 - Cursor 
out of ränge. Paddies are paired in the Controller jacks, so paddle 
0 and paddle 1 both use jack one. PADDL registers are shadows 
for POKEY locations 53760 to 53767 ($D200 to $D207). 


625 271 PADDL1 

This and the next six bytes are the same as 624, but for the other 
paddles. 


626 

272 

PADDL2 

627 

273 

PADDL3 

628 

274 

PADDL4 

629 

275 

PADDL5 

630 

276 

PADDL6 

631 

277 

PADDL7 

632 

278 

STICK0 


The value of joystick 0. STICK registers are shadow locations for 
PIA locations 54016 and 54017 ($D300, $D301). There are nine 
possible decimal values (representing 45 degree incrememts) 
read by each joystick register (using the STICKn command), 
depending on the position of the stick: 


Decimal 

14 

I 

10 | 6 
\ i/ 

11— 15-7 

/ l\ 

9 I 5 

I 

13 


Binary 

1110 

1010 | 0110 

\ 1/ 

1011 — 1111 —0111 
/ \ 

1001 | 0101 
1101 


15(1111) equals stick in the upright (neutral) position. 

See Micro, December 1981 ,for an article on making a 
proportional joystick. For an example of a machine language 
joystick driver you can add to your BASIC program, see 
COMPUTEI, July 1981. 

One machine language joystick reader is listed below, based on 
an article in COMPUTEI, August 1981: 

1 GoSub 1000 
10 LOOK = STICK(0) 

20 X = USR(1764,LOOK): Y = USR(1781, 

LOOK) 
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30 On X GoTo 120, 100, 110 


100 REM YOUR MOVE LEFT ROUTINE HERE 
105 GoTo 10 

110 REM YOUR MOVE RIGHT ROUTINE HERE 
115 GoTo 10 

120 On Y GoTo 150, 130, 140 

130 REM YOUR MOVE DOWN ROUTINE HERE 

135 GoTo 10 

140 REM YOUR MOVE UP ROUTINE HERE 
145 GoTo 10 

150 REM If X <> 1 Then Nothing DOING.BRANCH To YOUR OTHER ROUTINES Or To 155 
155 GoTo 10 

1000 For Loop = 1764 To 1790: Read BYTE: POKE Loop, Byte: Next Loop 
1010 DATA 104, 104, 133,213, 104,41,12,74,74,73, 2,24,105,1 
1020 DATA 133,212, 96,104, 104,133,213, 104,41,3, 76,237,6 
1030 Return 

See locations 88, 89 ($58, $59) for an example of a USR call using 
a string instead of a fixed memory location. 

633 279 STICK1 

This and the next two locations are the same as 632, but for the 
other joysticks. These four locations are also used to determine if 
a lightpen (PEN 0 - 3) switch is pressed. 


634 

27A 

STICK2 

635 

27B 

STICK3 

636 

27C 

PTRIG0 


Paddle trigger 0. Used to determine if the trigger or hutton on 
paddle 0 is pressed (zero is returned) or not (one is returned). 
Since these are the same lines as the joystick left/right switches, 
you can use PTRIG for horizontal movement. PTRIG(I) - 
PTRIG(O) returns -1 (left), 0 (center), + 1 (right). The next seven 
locations are for the other paddle buttons. PTRIG 0 - 3 are 
shadows for PIA register 54016 ($D300). 


637 

27D 

PTRIG1 

638 

27E 

PTRIG2 

639 

27F 

PTRIG3 

640 

280 

PTRIG4 


PTRIG 4-7 are shadows for PIA register 54017 ($D301). 

641 281 PTRIG5 

642 282 PTRIG6 

643 283 PTRIG7 

644 284 STRIG0 


Stick trigger 0. This and the next three locations perform the 
same function as the PTRIG locations except for the joysticks. 
Like PTBIG, zero is returned when the button is pressed; one is 
returned when it is not. STRIG registers are shadow registers for 
GTIA/CTIA locations 53264 to 53267 ($D010 to $D013). 


645 

285 

STRIG1 

646 

286 

STRIG2 
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647 


287 


STRIG3 


4 . 3.5 648 - 655 


Locations 648 to 655 ($288 to $28F) are for miscellaneous OS use. 


DECIMAL HEX 


LABEL 


648 288 CSTAT 

Cassette Status register. 


649 289 WMODE 

Register to störe either the read or the write mode for the cassette 
handler, depending on the Operation: zero equals read, 128 ($80) 
equals write. 


650 


28A 


BLIM 


Cassette data record butter size; contains the number of active 
data bytes in the cassette butter for the record being read or 
written, at location 1021 ($3FD). Values ränge from zero to 128 
(cassette record size is 128; $80). The pointer to the byte being 
read or written is at 61 ($3D). The value of BLIM is drawn from 
the control bytes that precede every cassette record, as 
explained in location 1021. 

651-655 28B-28F 

Spare bytes. It is not recommended that you use the spare bytes 
for your own program use. In later Upgrades of the OS, these 
bytes may be used, causing a conflict with your program. For 
example, the new OS ROMs use locations 652 and 653 ($28C, 
$28D) in the new IRQ interrupt handler routines. It is best to use a 
protected area of memory such as page six, locations 1536 to 
1791 ($600 to$6FF). 


4 . 3.6 656 - 703 

Locations 656 to 703 ($290 to $2BF) are used for the screen RAM display handler (depending on 
GRAPHICS mode). In split-screen mode, the text window is controlled by the screen editor (E:), 
while the graphics region is controlled by the display handler (S:), using two separate lOCB's. Two 
separate Cursors are also maintained. The display handler will set AUX1 of the IOCB to splitscreen 
Option. Refer to the IOCB area, locations 832 to 959 ($340 to $3BF). See COMPUTEI, February 
1982, for a program to put GR.1 and GR.2 into the text window area. The text window uses 160 
bytes of RAM located just below RAMTOP (see location 106; $6A). See location 88 ($58) for a 
chart of screen RAM use. 

DECIMAL HEX LABEL 

656 290 TXTROW 

Text window Cursor row; value ranges from zero to three (the text 
window has only four lines). TXTROW specifies where the next 
read or write in the text window will occur 

657,658 291,292 TXTCOL 

Text window Cursor column; value ranges from zero to 39. Unless 
changed by the user, location 658 will always be zero (there are 
only 40 columns in the display, so the MSB will be zero). Since 
POSITION, PLOT, LOCATE and similar commands refer to the 
graphics Cursor in the display area above the text window, you 
must use POKE Statements to write to this area if PRINT 
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Statements are insufficient. 

659 293 TINDEX 

Contains the current split-screen text window GRAPHICS mode. 
It is the split-screen equivalent to DINDEX (location 87; $57) and 
is always equal to zero when location 128 ($7B) equals zero. 
Initialized to zero (which represents GR.O). You can alter the 
display list to change the text window into any GRAPHICS mode 
desired. If you do so, remember to change TINDEX to reflect that 
alteration. 


660,661 294,295 TXTMSC 

Address of the upper left corner of the text window. Split-screen 
equivalent of locations 88, 89 ($58, $59). 

662-667 296-29B TXTOLD 

These locations contain the split-screen equivalents of OLDROW 
(90; $5A), OLDCOL (91,92; $5B, $5C), OLDCHR (location 93, 
$5D) and OLDADR (locations 94, 95; $5E, $5F). They hold the 
split-screen Cursor data. 

668 29C TMPX1 

Temporary register, used by the display handler for the scroll 
loop count record. 

669 29D HOLD3 

Temporary register. 

670 29E SUBTMP 

Temporary storage. 

671 29F HOLD2 

Temporary register. 


672 2A0 DMASK 

Pixel location mask. DMASK contains zeroes tor all bits which do 
not correspond to the specific pixel to be operated upon, and 
ones for bits which do correspond, according to the GRAPHICS 
mode in use, as follows: 


miiiii 

11110000 

00001111 

11000000 

00110000 

00001100 

00000011 

10000000 

01000000 


Modes 0, 
Modes 9, 


1 And 2: 

10 And 11: 


one pixel per screen display 
byte. 

two pixels per byte. 


Modes 3, 5 And 7: four pixels per byte. 


Modes 4, 6 And 8: eight pixels per byte. 


etc. To: 
00000001 


A pixel (short for picture cell or picture element) is a logical unit 
of Video size which depends on the GRAPHICS mode in use for 
its dimensions. The smallest pixel is in GR.8 where it is only .5 
color clock wide and one scan line high. In GR.O it is also only .5 
color clock wide, but it is eight scan lines high. Here is a chart of 
the pixel sizes for each mode: 


GR. mode 

0 

Text 

1 

Modes 

2 3 

4 

Graphics 
5 6 

modes 

7 

8 

Scan lines 
per pixel 

8 

8 

CO 

CD 

i—1 

4 

4 

2 

2 

1 
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Bits 

per pixel 111212121 

Color clocks 

per pixel .5 1 1 4 2 2 1 1.5 

Characters 

per Line 40 20 20 — — — — — — 

Pixels 

per width — — -- 40 80 80 160 160 320 


The number of pixels per screen width is based on the normal 
playfield screen. See location 559 ($22F) for Information on 
playfield size. 

673 2A1 TMPLBT 

Temporary storage for the bit mask. 

674 2A2 ESCFLG 

Escape flag. Normally zero, it is set to 128 ($80) if the ESC key is 
pressed (on detection of the ESC character; 27, $1B). It is reset to 
zero following the output of the next character. To display 
ATASCII control codes without the use of an ESC character, set 
location 766 ($2FE) to a non-zero value. 

675-689 2A3-2B1 TABMAP 

Map of the TAB stop positions. There are 15 byte (120 bits) here, 
each bit corresponding to a column in a logical line. A one in any 
bit means the TAB is set; to clear all TABs simply POKE every 
location with zero. There are 120 TAB locations because there 
are three physical lines to one logical line in GRAPHICS mode 
zero, each consisting of 40 columns. Setting the TAB locations for 
one logical line means they will also be set for each subsequent 
logical line until changed. Each physical line in one logical line 
can have different TAB settings, however. 

To POKE TAB locations from BASIC, you must POKE in the 
number (i.e., set the bit) that corresponds to the location of the 
bit in the byte (there are five bytes in each line). For example: 

To set tabs at locations 5, 23, 27 and 32, first visualize the line as a 
string of zeros with a one at each desired tab setting: 

0000100000000000000000100010000100000000 

Then break it into groups of eight bits (one byte units). There are 
three bytes with ones (bits set), two with all zeros: 


00001000 = 8 
00000000 = 0 
00000010 = 2 
00100001 = 33 
00000000 = 0 


Converting these to decimal, we get the values listed at the right 
of each byte. These are the numbers you'd POKE into locations 
675 (the first byte) to 679 (the fifth byte on the line). On powerup 
or when you OPEN the display screen (S: or E:), each byte is 
given a value of one (i.e., 00000001) so that there are tab default 
tab stops at 7, 15, 23, etc., incrementing by eight to 119. Also, 
the leftmost screen edge is also a valid TAB stop (2, 42, and 82). 
In BASIC, these are set by the SET-TAB and CLR-TAB keys. 
TABMAP also works for the lines in the text display window in 
split-screen formats. TABMAP is reset to the default values on 
pressing RESET orchanging GRAPHICS modes. 

See location 201 ($C9) about changing the TAB settings used 
when a PRINT Statement encounters a comma. 


Converted and layouted 2006 by Andreas Bertelmann for ABBUC 









Memory map 


690-693 2B2-2B5 LOGMAP 

Logical line Start bit map. These locations map the beginning 
physical line number for each logical line on the screen (initially 
24, for GR.O). Each bit in the first three bytes shows the Start of a 
logical line if the bit equals one (three bytes equals eight bits * 
three equals 24 lines on the screen). The map format is as follows: 

Bit 76543210 Byte 


Line 01234567 690 

8 9 10 11 12 13 14 15 691 

16 17 18 19 20 21 22 23 692 

693 


The last byte is ignored. The map bits are all set to one when the 
text screen is OPENed or CLEARed, when a GRAPHICS com- 
mand is issued or RESET is pressed. The map is updated as 
logical lines are entered, edited, or deleted. 

694 2B6 INVFLG 

Inverse character flag; zero is normal and the initialization value 
(i.e., normal ATASCII Video Codes have BIT 7 equals zero). You 
POKE INVFLG with 128 ($80) to get inverse characters (BIT 7 
equals one). This register is normally set by toggling the Atari 
logo key; however, it can be user-altered. The display handler 
XOR's the ATASCII Codes with the value in INVFLG at all times. 
See location 702 ($2BE) below. 

INVFLG works to change the input, not the output. For example, 
if you have A$ = "HELLO", POKE 694, 128 will not change A$ 
when you PRINT it to the screen. However, if you POKE 694, 128 
before an INPUT A$, the String will be entered as inverse. 

695 2B7 FILFLG 

Right fill flag for the DRAW command. If the current Operation is 
a DRAW, then this register reads zero. If it is non-zero, the 
Operation is a FILL. 

696 2B8 TMPROW 

Temporary register for row used by ROWCRS (location 84; $54). 

697,698 2B9,2BA TMPCOL 

Temporary register for column used by COLCRS (locations 85, 
86; $55, $56). 

699 2BB SCRFLG 

Scroll flag; set if a scroll occurs. It counts the number of physical 
lines minus one that were deleted from the top of the screen. This 
moves the entire screen up one physical line for each line 
scrolled off the top. Since a logical line has three physical lines, 
SCRFLG ranges from zero to two. 

Scrolling the text window is the equivalent to Scrolling an entire 
GR.O screen. An additional 20-line equivalent of bytes (800) is 
scrolled upwards in the memory below the text window address. 
This can play havoc with any data such as P/M graphics you have 
stored above RAMTOP 

700 2BC HOLD4 

Temporary register used in the DRAW command only; used to 
save and restore the value in ATACHR (location 763; $2FB) 
during the FILL process. 
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701 2BD HOLD5 

Same as the above register. 


702 


2BE 


SHFLOK 


Flag for the shift and control keys. It returns zero for lowercase 
letters, 64 ($40) for all uppercase (called caps lock: uppercase is 
required for BASIC Statements and is also the default mode on 
powerup). SFIFLOK will set characters to all caps during your 
program if 64 is POKEd here. Returns the value 128 ($80; 
control-lock) when the CTRL key is pressed. Forced control-lock 
will cause all keys to output their control-code functions or 
graphics figures. Other values POKEd here may cause the 
System to crash. You can use this location with 694 ($2B6) above 
to convert all keyboard entries to uppercase, normal display by: 

10 Open #2,4,0, "K:" 

20 Get #2,A 

30 GoSub 1000 

40 Print CHR$(A) ; : GoTo 20 


1000 If A = 155 Then 1030: REM Return KEY 

1010 If A > = 128 Then A = A - 128: REM RESTORE To NORMAL DISPLAY 
1020 If PEEK (702) = 0 And A > 96 Then A = A - 32: REM LOWERCASE To UPPER 
1030 POKE 702,64: POKE 694,0 
1040 Return 


BOTSCR 


2BF 


703 


Flag for the number of text rows available for printing. 24 ($18) is 
normal for text mode GR.0; four for the text window, zero for all 
graphics modes. In all GRAPHICS modes except zero, if there is 
no text window then 703 will also read zero. The large-text 
displays in GR.1 and GR.2 are treated as graphics displays for 
this purpose. The display handler specifically checks for split- 
screen mode by looking for the variable 24 or four here. If it finds 
24 here, it assumes there is no text window; if not, it looks for the 
variable four. 

You can add a text window to GR.0 by POKEing here with four. 
The top portion (20 lines) of the screen will not scroll with the 
bottom. To write to the top part of the screen you will have to use 
the PRINT#6 Statement as with modes one and two. One possible 
application of this would be to keep a fixed menu at the top of the 
screen while Scrolling the bottom part, as done with the DOS 
menu. 


4 . 3.7 704-712 

Locations 704 to 712 ($2C0 to $2C8) are the color registers for players, missiles, and playfields. 
These are the RAM shadow registers for locations 53266 to 53274 ($D012 to $D01 A). For the 
latter, you can use the SETCOLOR command from BASIC. For all registers you can POKE the 
desired color into the location by using this formula: 

COLOR = HUE * 16 + LUMINANCE 

It is possible to get more colors in GR.8 than the one (and a half) that Atari says is possible by 
using a technique called artifacting. There is a small example of artifacting shown at location 710 
($2C6). See De Re Atari, Your Atari 400/800, Creative Computing, June 1981, and COMPUTEI, 
May 1982. 

Here are the 16 colors the Atari produces, along with their POKE values for the color registers. The 
POKE values assume a luminance of zero. Add the luminance value to the numbers to brighten 
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the color. The color registers ignore BIT 0; that's why there are no "odd" values for luminance, just 
even values. 


Color 


Value 

Color 


Value 

Black 

0 , 

0 

Medium blue 

8, 

128 

Rust 

1 , 

16 

Dark blue 

9, 

144 

Red-orange 

2, 

32 

Blue-grey 

o 

t—1 

160 

Dark orange 

3, 

48 

Olive green 

11, 

176 

Red 

4, 

64 

Medium green 

12, 

192 

Dk lavender 

5 , 

80 

Dark green 

13, 

208 

Cobalt blue 

6, 

96 

Orange-green 

14, 

224 

Ultramarine 

7, 

112 

Orange 

15, 

240 


The bit use of the PCOLR and COLOR registers is as follows: 


Bit 7 6 5 4 

—color— 
Grey 0000 

Rust 0001 

etc. To: 

Orange 1111 


3 2 10 

luminance unused 
000 Darkest 
0 0 1 

etc. To: 

111 Lightest 


When you enable the color overlap at location 623 ($26F), ANTIC performs a logical OR on the 
overlap areas. For example: 

01000010 Red, luminance two 
Or 10011010 Darkblue,luminance ten 

Result = 10011010 Dark green, luminance ten 


Here's a short machine language routine which will rotate the colors in registers 705 to 712: 

10 Dim ROT $(30) 

20 For Loop = 1 To 27: Read Byte: ROT$(Loop, Loop) = CHR$(Byte): Next Loop 
PUT YOUR GRAPHICS ROUTINE HERE 
100 CHANGE = USR(ADR(ROT$)) 

105 For Loop = 1 To 200: Next Loop: GoTo 100 
110 DATA 104,162, 0,172,193, 2,189, 194,2,157 
120 DATA 193,2,232,224,8,144,245,140,200,2 
130 DATA 96, 65, 65, 65, 65, 65, 65 

If you wish to rotate the colors in registers 704 to 711 instead, change lines 110 and 120 to read as 
follows: 

110 DATA 104,162, 0,172,192,2,189, 193, 2,157 
120 DATA 192,2,232,224,8,144,245,140,199,2 

If you wish to include all of the registers 704 to 712 in the routine, make the changes as above and 
change the eight in line 120 to nine and restore the 199 to 200 in line 120. This routine works well 
with the GTIA demos at location 623 ($26F). 

For further detail, refer to your Atari BASIC Reference Manual, pp. 45 -56, and the GTIA Demo 
Disk from APX. 

DECIMAL HEX LABEL 

704 2C0 PCOLRO 

Color of player 0 and missile 0. Locations 704 to 707 are also 
called COLPM# in some sources. This is the shadow for 53266 
($D012). In GTIA mode ten, 704 holds the background color 
(BAK; normally held by 712). You cannot use the SETCOLOR 
commands to change the PCOLR registers; color values must be 
POKEd into them. 


705 2C1 PCOLR1 

Color of player and missile 1. Shadow for 53267 ($D013). 

706 2C2 PCOLR2 
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Color of player and missile 2. Shadow for 53268 ($D014). 

707 2C3 PCOLR3 

Color of player and missile 3. When the four missiles are 
combined to make a fifth player, it takes on the color in location 
711 (COLOR3). Shadow for 53269 ($D015). 

708 2C4 COLORO 

Color register zero, color of playfield zero, controlled by the 
BASIC SETCOLORO command. In GRAPHICS 1 and 
GRAPHICS 2, this color is used for the uppercase letters. 
Shadow for 53270 ($D016). You can change the values in all of 
the COLOR registers from BASIC by using either the 
SETCOLOR command or a POKE. 

709 2C5 COLOR1 

The next four locations are the same as location 708 for the 
different playfields and SETCOLOB commands. In GR.1 and 
GR.2, this register Stores the color for lowercase letters. 

COLOR1 is also used to störe the luminance value of the color 
used in GR.O and GR.8. Shadow for 53271 ($D017). 

710 2C6 COLOR2 

The same as above for playfield two; in GR.1 and GR.2, this 
register Stores the color of the inverse uppercase letters. Shadow 
for 53272 ($D018). Used for the background color in GR.O and 
GR.8. Both use COLOR1 for the luminance value. 

Despite the official limitations of color selection in GR.8, it is 
possible to generate additional colors by "artifacting", turning 
on specific pixels (.5 color clock each) on the screen. Taking 
advantage of the physical structure of the TV set itself, we 
selectively turn on vertical lines of pixels which all show the same 
color. For example: 

10 A = 40: B = 30: C = 70: D = 5: F= 20 GRAPHICS 8: 

POKE 87,7: POKE 710,0: POKE 709,15: COLOR 1 
30 PLOT A,D: DRAWTO A,C: COLOR 2: PLOT F, D: DRAWTO F,C: 
40 PLOT A + 1,D: DRAWTO A + 1,C 
50 COLOR 3: PLOT B,D: DRAWTO B,C 
60 GoTo 60 


A little experimentation with this will show you that the colors 
obtained depend on which pixels are turned on and how close 
together the pixel columns are. There are four "colors" you can 
obtain, as shown before. Pixels marked one are on; marked zero 
means they are off. Each pair of pixels is one color clock. Three 
color clocks are shown together for clarity: 

00:01:00 = color A 00:11:00 = color B 

00:10:00 = color C 00:01:10 = color D 

See BYTE, May 1982, De Re Atari, and Your Atari 400/800. 

711 2C7 COLOR3 

The same as the above but for playfield three. Also, the color for 
GR.1 and GR.2 inverse lowercase letters. Shadow for 53273 
($D019). 

712 2C8 COLOR4 

The same as the above but for the background (BAK) and border 
color. Shadow for 53274 ($D01 A). In GTIA mode ten, 704 Stores 
the background color (BAK), while 712 becomes a normal color 
register. 
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Here are the default (powerup) values for the COLOR registers 
(PCOL registers are all set to zero on powerup): 


Reg: 

ister 


Color 

= Hue 

Luminance 

708 

(CO. 

.0) 

40 

2 

8 

709 

(CO. 

.1) 

202 

12 

10 

710 

(CO. 

■ 2) 

148 

9 

4 

711 

(CO. 

.3) 

70 

4 

6 

712 

(CO. 

.4) 

0 

0 

0 


4 . 3.8 713-735 

Locations 713 to 735 ($2C9 to $2DF) are spare bytes. 

4 . 3.9 736 - 767 

Locations 736 to 767 ($2E0 to $2FF) are for miscellaneous use. 

DECIMAL HEX LABEL 

736-739 2E0-2E3 GLBABS 

Global variables, or, tour spare bytes for non DOS users. For 
DOS users they are used as below: 

736-737 2E0-2E1 RUNAD 

Used by DOS for the run address read from the disk sector one or 
from a binary file. Upon completion of any binary load, control 
will normally be passed back to the DOS menu. However, DOS 
can be forced to pass control to any specific address by storing 
that address here. If RUNAD is set to 40960 ($A000), then the left 
cartridge (BASIC if inserted) will be called when the program is 
booted. 

With DOS 1.0, if you POKE the address of your binary load file 
here, the file will be automatically run upon using the DOS 
Binary Load (selection L). Using DOS 1.0's append (/A) Option 
when saving a binary file to disk, you can cause the load address 
POKEd here to be saved with the data. In DOS 2.0, you may 
specify the initialization and the run address with the program 
name when you save it to disk (i.e., 

GAME.OBJ,2000,4FFF,4F00,4000). DOS 2.0 uses the /A Option 
to merge files. In order to prevent your binary files from running 
automatically upon loading in DOS 2.0, use the /N appendage to 
the file name when loading the file. 

For users of CompuServe, there is an excellent little BASIC 
program (with machine language subroutines) to create autoboot 
files, chain machine language files with BASIC and to add an 850 
autoboot file in the Populär Electronics Magazine (PEM) access 
area. It is available free for downloading. 

738-739 2E2-2E3 INITAD 

Initialization address read from the disk. An autoboot file must 
load an address value into either RUNAD above or INITAD. The 
code pointed to by INITAD will be run as soon as that location is 
loaded. The code pointed to by RUNAD will be executed only 
after the entire load process has been completed. To return 
control to DOS after the execution of your program, end your 
code with an RTS instruction. 

740 2E4 RAMSIZ 

RAM size, high byte only; this is the number of pages that the top 
of RAM represents (one page equals 256 bytes). Since there can 
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never be less than a whole page, it becomes practical to measure 
RAM in those page units. This is the same value as in RAMTOP, 
location 106 ($6A), passed here from TRAMSZ, location 6. Space 
saved by moving RAMSIZ or RAMTOP has the advantage of 
being above the display area. Initialized to 160 for a 48K Atari. 

741,742 2E5,2E6 MEMTOP 

Pointer to the top of free memory used by both BASIC (which 
calls it HIMEM) and the OS, passed here from TRAMSZ, location 
6 after powerup. This address is the highest free location in RAM 
for programs and data. The value is updated on powerup, when 
RESET is pressed, when you change GRAPHICS mode, or when 
a channel (IOCB) is OPENed to the display. The display list Starts 
at the next byte above MEMTOP. 

The screen handler will only OPEN the S: device if no RAM is 
needed below this value (i.e. there is enough free RAM below 
here to accommodate the requested GRAPHICS mode change). 
Memory above this address is used for the display list and the 
screen display RAM. Also, if a screen mode change would 
extend the screen mode memory below APPMHI (locations 14, 

15: $E, $F), then the screen is set back for GR.O, MEMTOP is 
updated, and an error is returned to the user. Otherwise the 
mode change will take place and MEMTOP will be updated. 

Space saved by moving MEMTOP is below the display list. Be 
careful not to overwrite it if you change GRAPHICS modes in 
mid-program. When using memory below MEMTOP for storage, 
make sure to set APPMHI above your data to avoid having the 
screen data descend into it and destroy it. 

743,744 2E7,2E8 MEMLO 

Pointer to the bottom of free memory, initialized to 1792 ($700) 
and updated by the presence of DOS or any other low-memory 
application program. It is used by the OS; the BASIC pointer to 
the bottom of free memory is at locations 128, 129 ($80, $81). The 
value in MEMLO is never altered by the OS after powerup. 

This is the address of the first free location in RAM available for 
program use. Set after all FMS buffers have been allocated (see 
locations 1801 and 1802; $709 and $70A). The address of the last 
sector buffer is incremented by 128 (the buffer size in bytes) and 
the value placed in MEMLO. The value Updates on powerup or 
when RESET is pressed. This value is passed back to locations 
128, 129 ($80, $81) on the execution of the BASIC NEW 
command, but not RUN, LOAD or RESET. 

If you are reserving space for your own device driver(s) or 
reserving buffer space, you load your routine into the address 
specified by MEMLO, add the size of your routine to the MEMLO 
value, and POKE the new value plus one back into MEMLO. 

When you don't have DOS or any other application program 
using low-memory resident, MEMLO points to 1792 ($700. With 
DOS 2.0 present, MEMLO points to 7420 ($1CFC). If you change 
the buffer defaults mentioned earlier, you will raise or lower this 
latter value by 128 ($80) bytes for every buffer added or deleted, 
respectively. When you boot up the 850 Interface with or without 
disk, you add another 1728 ($6C0) bytes to the value in MEMLO. 

You can alter MEMLO to protect an area of memory below your 
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program. This is an alternative to protecting an area above 
RAMTOP (location 106; $6A) and avoids the problem of the 
CLEAR SCREEN routine destroying data. However, unless you 
have created a MEM.SAV file, the data will be wiped out when 
you call DOS. To alter MEMLO, you Start by POKEing WÄRMST 
(location 8) with zero, then doing a JMP to the BASIC Cartridge 
entry point at 40960($A000) after defining your area to protect. 

For example, try this: 

10 Dim MEM$(24):PROTECT=700:REM NUMBER OF BYTES To CHANGE 

15 HIBYTE=INT(PROTECT/256):LOBYTE=PROTECT-256*HIBYTE 

20 For N=1 To 24:Read PRG:MEM$(N)=CHR$(PRG): Next N 

30 MEM$(6,6)=CHR$(LOBYTE):MEM$(14,14)=CHR$(HIBYTE) 

40 RESERVE=USR(ADR(MEM$)) 

50 DATA 24,173,231,2,105,0,141,231,2,173,232,2,105 

60 DATA 0,141,232,2, 169,0,133, 8,76,0,160 

You will find the address of your reserved memory by: PRINT 
PEEK(743) + PEEK(744) * 256 before you run the program. This 
program will wipe itself out when run. Altering MEMLO is the 
method used by both DOS and the RS-232 port driver in the 850 
Interface. See COMPUTEI, July 1981. 

745 2E9 

Spare byte. 

746-749 2EA-2ED DVSTAT 

Four device Status registers used by the I/O Status Operation as 
follows: 

746 ($2EA) is the device error Status and the command Status 
byte. If the Operation is a disk I/O, then the Status returned is that 
of the 1771 Controller Chip in your Atari disk drive. Bits set to one 
return the following error codes: 

Bit Decimal Error 

0 1 An invalid command frame was received (Error). 

1 2 An invalid data frame was received. 

2 4 An Output Operation was unsuccessful . 

3 8 The disk is Write-protected. 

4 16 The System is inactive (On standby). 

7 32 The peripheral Controller is "intelligent" (has its 

own microprocessor: the disk drive). All Atari 
devices are intelligent except the cassette 
recorder, so BIT 7 will normally be one when a 
device is attached. 


747 ($2EB) is the device Status byte. For the disk, it holds the 
value of the Status register of the drive Controller. For the 850 
Interface, it holds the Status for DSR,CTS,CRX and RCV when 
concurrent I/O is not active (see the 850 Interface Manual). It also 
contains the AUX2 byte value from the previous Operation (see 
the IOCB description at 832 to 959; $340 to $3AF). 

748 ($2EC) is the maximum device time-out value in seconds. A 
value of 60 here represents 64 seconds. This value is passed back 
to location 582 ($246) after every disk Status request. Initialized to 
31. 

749 ($2ED) is used for number of bytes in output buffer. See 850 
Manual, p. 43. 

When concurrent I/O is active, the STATUS command returns 
the number of characters in the input buffer to locations 747 and 

748, and the number of characters in the output buffer to location 

749. 

750,751 2EE,2EF CBAUDL/H 

Cassette baud rate low and high bytes. Initialized to 1484 
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($5CC), which represents a nominal 600 baud (bits per second). 
After baud rate calculations, these locations will contain POKEY 
values for the corrected baud rate. The baud rate is adjusted by 
SIO to account for motor variations, tape Stretch, etc. The 
beginning of every cassette record contains a pattern of 
alternating off/on bits (zero/one) which are used solely for speed 
(baud) correction. 

752 2F0 CRSINH 

Cursor inhibit flag. Zero turns the Cursor on; any other number 
turns the Cursor off. A visible Cursor is an inverse blank (space) 
character. Note that Cursor visibility does not change until the 
next time the Cursor moves (if changed during a program). If you 
wish to change the Cursor Status without altering the screen data, 
follow your CRSINH change with a Cursor movement (i.e., up, 
down) sequence. This register is set to zero (Cursor restored) on 
powerup, RESET, BREAK, or an OPEN command to either the 
display handler (S:) or screen editor (E:). See location 755 for 
another means to turn off the Cursor. 

753 2F1 KEYDEL 

Key delay flag or key debounce counter; used to see if any key 
has been pressed. If a zero is returned, then no key has been 
pressed. If three is returned, then any key. It is decremented 
every stage two VBLANK (1/60 or 1/30th second) until it reaches 
zero. If any key is pressed while KEYDEL is greater than zero, it 
is ignored as "bounce." See COMPUTEI, December 1981, for a 
routine to change the keyboard delay to suit your own typing 
needs. 

754 2F2 CHI 

Prior keyboard character code (most recently read and 
accepted). This is the previous value passed from 764 ($2FC). If 
the value of the new key code equals the value in CHI, then the 
code is accepted only if a suitable key debounce delay has taken 
place since the prior value was accepted. 

755 2F3 CHACT 

Character Mode Register. Zero means normal inverse 
characters, one is blank inverse characters (inverse characters 
will be printed as blanks, i.e., invisible), two is normal 
characters, three is solid inverse characters. Four to seven is the 
same as zero to three, but prints the display upside down. 

This register also Controls the transparency of the Cursor. It is 
transparent with values two and six, opaque with values three 
and seven. The Cursor is absent with values zero, one, four and 
five. 

Toggling BIT 0 on and off can be a handy way to produce a 
blinking effect for printed inverse characters (characters with 
ATASCII values greater than 128 -- those that have BIT 7 set). 
Shadow for 54273 ($D401). There is no visible Cursor for the 
graphics mode output. CHACT is initialized to two. 

Here's an example of blinking text using this register: 

10 CHACT=755:REM USE INVERSE For WORDS BELOW 
15 Print "[THIS IS A TEST OF BLINKING] [TEXT]" 

20 POKE CHACT,INT(RND(0)*4) 

30 For N=1 To 100:Next N:GoTo 15 

See COMPUTEI, December 1981. 

Using a machine language routine and page six space, try: 
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10 PAGE=1536: Exit = 1568 

20 For N=PAGE To Exit:Read Byte:POKE N,Byte:Next N 
30 PGM=USR (PAGE) 

40 Print "[THIS] IS A [TEST] OF [BLINKING] TEXT":REM MAKE SOME WORDS INVERSE 
50 GoTo 50 

60 DATA 104, 169, 17, 141, 40,2, 169, 6, 141,41 
70 DATA 2,169,30,141,26,2, 98,173, 243,2 
80 DATA 41, 1,73,1,141,243,2, 169, 30,141,26, 2, 96 

The blink frequency is set .5 second; to change it, change the 
30 in line 80 to any number from one (1/30 second) to 255 (eight 
.5 seconds). For another way to make the Cursor visible or 
invisible, see locations 752 above. 

756 2F4 CH BAS 

Character Base Register, shadow for 54281 ($D409). The default 
(initialization value) is 224 ($E0) for uppercase characters and 
numbers; POKE CHBAS with 226 ($E2) to get the lowercase and 
the graphics characters in GR.1 and GR.2. In GR.O you get the 
entire set displayed to the screen, but in GR.1 and GR.2, you 
must POKE 756 for the appropriate half-set to be displayed. 

How do you create an altered character set? First you must 
reserve an area in memory for your set (512 or 1024 bytes; look at 
location 106; $6A to see how). Then either you move the ROM set 
(or half set, if that's all you intend to change) into that area and 
alter the selected characters, or you fill up the space with bytes 
which make up your own set. Then you POKE 756 with the MSB 
of the location of your set so the Computer knows where to find it. 

What does an altered character set look like? Each character is a 
block one byte wide by eight bytes high. You set the bits for the 
points on the screen you wish to be "on" when displayed. Here 


are two examples: 


one Byte wide: 

00100000 = 32 

# 

00010000 = 16 

# 

00010000 = 16 

# 

00010000 = 16 

# 

00011110 = 30 

#### 

00000010 = 2 

# 

00001100 = 12 

## 

00010000 = 16 

Hebrew letter Lamed 

# 


one Byte wide: 
10000001 = 129 

# # 

10011001 = 153 

# ## # 

10111101 = 189 

# #### # 

11111111 = 255 

######## 

11111111 = 255 

######## 

10111101 = 189 

# #### # 

10011001 = 153 

# ## # 

10000001 = 129 

# # 


Tie-fighter 

You can turn these characters into DATA Statements to be POKEd 
into your reserved area by using the values for the bytes as in the 
above examples. To change the ROM set once it is moved, you 
look at the internal code (see the BASIC Reference Manual, p. 

55) and find the value of the letter you want to replace--such as 
the letter A-code 33. Multiply this by eight bytes for each code 
number from the Start of the set (33 * eight equals 264). You then 
replace the eight bytes used by the letter A, using a FOR-NEXT 
loop with the values for your own character. For example, add 
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these lines to the machine language found a few pages further on: 

1000 For Loop=l To 4: Read CHAR:Set=CHACT+CHAR*8 

1010 For TIME=0 To 7:Read Byte:POKE SET+TIME, Byte : Next TIME 

1020 Next Loop 

1030 DATA 33, 0,120, 124,22,22,124, 120,0 
1040 DATA 34,0, 126,82,82,82, 108,0,0 
1050 DATA 35, 56, 84,254,238,254, 68,56,0 
1060 DATA 36, 100, 84,76, 0,48,72,72,48 
2000 End 

RUN it and type the letters A to D. 

Why 224 and 226? Translated to hex, these values are $E0 and 
$E2, respectively. These are the high bytes (MSB) for the location 
of the character set stored in ROM: $E000 (57344) is the address 
for the Start of the set (which begins with punctuation, numbers 
and uppercase letters), and $E200 (57856), for the second half of 
the ROM set, lowercase and graphic control characters (both 
Start on page boundaries). The ROM set uses the internal order 
given on page 55 of your BASIC Reference Manual, not the 
ATASCII order. See also location 57344 ($E000). 

You will notice that using the PRINT#6 command will show you 
that your characters have more than one color available to them 
in GR.1 and GR.2. Try PRINTing lowercase or inverse 
characters when you are using the uppercase set. This effect can 
be very useful in creating colorful text pages. Uppercase letters, 
numbers, and special characters use color register zero (location 
708; $2C4 - orange) for normal display, and color register two 
(710; $2C6 - blue) for inverse display. Lowercase letters use 
register one (709; $2C5 - aqua) for normal display and register 
three (711; $2C7 - pink) for inverse. See COMPUTER December 

1981, page 98, for a discussion of using the CTRL keys with letter 
keys to get different color effects. 

One problem with POKEing 756 with 226 is that there is no blank 
space character in the second set: you get a screen full of hearts. 
You have two choices: you can change the color of register zero 
to the same as the background and lose those characters which 
use register zero--the control characters--but get your blanks 
(and you still have registers one, two and three left). Or you can 
redefine your own set with a blank character in it. The latter is 
obviously more work. See "Ask The Readers," COMPUTEI, July 

1982. 

It is seldom mentioned in the manuals, but you cannot set 756 to 
225 ($EI) or any other odd number. Doing so will only give you 
screen garbage. The page number 756 points to must be evenly 
divisible by two. 

When you create your own character set and störe it in memory, 
you need to reserve at least 1K for a full character set (1024 bytes 
--$400 or four pages), and you must begin on a page boundary. 

In hex these are the numbers ending with $XX00 such as $C000 
or $600 because you störe the pointer to your set here in 756; it 
can only hold the MSB of the address and assumes that the LSB is 
always zero-or rather a page boundary. You can reserve 
memory by: 

POKE 106,PEEK(106)-4 (or any multiple of four) 

And do a GRAPHICS command immediately after to have your 
new memory value accepted by the Computer. If you are using 
only one half of the entire set, for GR.1 or GR.2, you need only 
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reserve 512 bytes, and it may begin on a .5K boundary (like 
$E200; these are hexadecimal memory locations that end in 
$X200). If you plan to switch to different character sets, you will 
need to reserve the full 1K or more, according to the number of 
different character sets you need to display. RAM for half-K sets 
can be reserved by: 

POKE 106,PEEK(106)-2 (or a multiple of two) 

The location for your set will then begin at PEEK(106)*256. 
Because BASIC cannot always handle setting up a display list for 
GR.7 and GR.8 when you modify location 106 by less than 4K (16 
pages), you may find you must use PEEK(106)-16. See location 
88,89 ($58,$59) and 54279 ($D407) for Information regarding 
screen use and reserving memory. 

Make sure you don't have your character set overlap with your 
player/missile graphics. Be very careful when using altered 
character sets in high memory. Changing GRAPHICS modes, a 
CLEAR command, or scrolling the text window all clear memory 
past the screen display. When you scroll the text window, you 
don't simply scroll the four lines; you actually scroll a full 24 (20 
additional lines * 40 bytes equals 800 bytes scrolled past 
memory)! This messes up the memory past the window display 
address, so Position your character sets below all possible 
interference (or don't scroll or clear the screen). 

You can create and störe as many character sets as your memory 
will allow. You switch back and forth between them and the ROM 
set by simply POKEing the MSB of the address into 756. Of 
course, you can display only one set at a time unless you use an 
altered display list and DU to call up other sets. There are no 
restrictions outside of memory requirements on using altered 
character sets with P/M graphics as long as the areas reserved for 
them do not overlap. 

A GRAPHICS command such as GR.0, RESET or a DOS call 
restores the character set pointer to the ROM location, so you 
must always POKE it again with the correct location of your new 
set after any such command. A useful place to störe these sets is 
one page after the end of RAM, assuming you've gone back to 
location 106 ($6A) and subtracted the correct number of pages 
from the value it holds (by POKE 106,PEEK(106) minus the 
number of pages to be reserved; see above). Then you can reset 
the character set location by simply using POKE 
756,PEEK(106)+1 (the plus one simply makes sure you Start at 
the first byte of your set). 

A full character set requires 1024 bytes (1K: four pages) be 
reserved for it. Why? Because there are 128 characters, each 
represented by eight bytes, so 128 * eight equals 1024. If you are 
using a graphics mode that uses only half the character set, you 
need only reserve 512 bytes (64 * eight equals 512). Remember to 
begin either one on a page boundary (1K boundary for full sets or 
.5K for half sets). By switching back and forth between two 
character sets, you could create the illusion of animation. 

Many magazines have published good Utilities to aid in the 
design of altered character sets, such as the January 1982 
Creative Computing, and SuperFont in COMPUTEI, January 
1982. I suggest that you examine The Next Step from Online, 
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Instedit from APX, or FontEdit from the Code Works for very 
useful set generators. One potentially useful way to alter just a 
few of the characters is to duplicate the block of memory which 
holds the ROM set by moving it byte by byte into RAM. A BASIC 
FOR-NEXT loop can accomplish this, although it's very slow. For 
example: 

5 CH=57344 

10 START=PEEK(106)-4:PLACE=START*256: 

POKE 106,PEEK(106)-5:GRAPHICS 0: 

REM RESERVE EXTRA In Case OF SCREEN CLEAR 
20 For Loop=0 To 1023:POKE PLACE+Loop 

,PEEK(CH+Loop):Next Loop:REM MOVE THE ROM Set 
30 POKE 756, PLACE/25 6:REM TELL ANTIC 
WHERE CHSET IS 


Here ' s a machine language routine to move the set: 

10 Dim Byte$ (80) 

15 REM MEM-1 To PROTECT Set FROM CLEAR SCREEN DESTRUCTION (SEE LOC.88) 

20 MEM=PEEK(106)-4:POKE 106,MEM-1: CHACT=MEM*256:GRAPHICS 0 

30 For Loop=l To 32:Read PGM: Byte$ (LOOP, Loop) =CHR$(PGM): Next Loop 

40 DATA 104,104,133,213,104,133,212 

50 DATA 104,133,215,104,133,214,162 

60 DATA 4,160,0,177,212,145,214 

70 DATA 200,208,249,230,213,230,215 

80 DATA 202,208,240,96 

90 Z=USR(ADR(Byte$),224*256, CHACT) 

. ADD YOUR OWN ALTERATION PROGRAM Or THE EARLIER EXAMPLE HERE 


1500 POKE MEM-1,0:POKE 756,MEM 

If you have Microsoft BASIC or BASIC A+, you can do this very 
easily with the MOVE command! 

Remember, when altering the ROM set, that the characters aren't 
in ATASCII Order; rather they are in their own internal Order. 

Your own set will have to follow this order if you wish to have the 
characters correlate to the keyboard and the ATASCII values. 

See page 55 of your BASIC Reference Manual for a listing of the 
internal order. Creative Computing, January 1982, had a good 
article on character sets, as well as a useful method of 
transferring the ROM set to RAM using string manipulation. See 
also "Using Text Plot for Animated Games" in COMPUTER April 
1982, for an example of using character sets for animated 
graphics. 

757-761 2F5-2F9 

Spare bytes. 

762 2 FA CHAR 

Internal code value for the most recent character read or written 
(internal code for the value in ATACFIR below). This register is 
difficult to use with PEEK Statements since it returns the most 
recent character; most often the Cursor value (128, $80 for a 
visible, zero for an invisible Cursor). 

763 2FB ATACFIR 

Returns the last ATASCII character read or written or the value of 
a graphics point. ATACFIR is used in Converting the ATASCII 
code to the internal character code passed to or from CIO. It also 
returns the value of the graphics point. The FILL and DRAW 
commands use this location for the color of the line drawn, 
ATACFIR being temporarily loaded with the value in FILDAT, 
location 765; $2FD. To force a color change in the line, POKE the 
desired color number here (color * sixteen + luminance). To see 
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this register in use as character storage, try: 

10 Open#2,4,0,"K:" 

20 Get#2,A 

30 Print PEEK(763);" CHR$(A) 

40 GoTo 20 

Make sure the PEEK Statement comes betöre the PRINT CHR$ 
Statement, or you will not get the proper value returned. When 
the RETURN key is the last key pressed, ATACHR will show a 
value of 155. 

764 2FC CH 

Internal hardware value for the last key pressed. POKE CH with 
255 ($FF; no key pressed) to clear it. The keyboard handler gets 
all of its key data from CH. It Stores the value 255 here to indicate 
the key code has been accepted, then passes the code to CHI, 
location 754 ($2F2). It the value in CH is the same as in CHI, a 
key code will be accepted only if the proper key debounce delay 
time has transpired. If the code is the CTRL-1 combination (the 
CTRL and the "1" keys pressed simultaneously), then the 
start/stop flag at 767 ($2FF) is complemented, but the value is not 
stored in CH. The auto repeat logic will also störe störe key 
information here as a result of the continuous pressing of a key. 
This is neither the ATASCII nor the internal code value; it is the 
"raw" keyboard matrix code for the key pressed. The table for 
translation of this code to ATASCII is on page 50 of the OS User's 
Manual. In a two-key Operation, BIT 7 is set if the CTRL key is 
pressed, BIT 6 if the SHIFT key is pressed. The rest of the bytes 
are the code (ignored if both BITs 7 and 6 are set). Only the code 
for the last key pressed is stored here (it is a global variable for 
keyboard). 

When a read request is issued to the keyboard, CH is set to 255 
by the handler routine. After a keycode has been read from this 
register, it is reset to 255. BREAK doesn't show here, and CTRL 
and SHIFT will not show here on their own. However, the inverse 
toggle (Atari logo key), CAPS/LOWR, TAB and the ESC keys 
will show by themselves. You can examine this register with: 

10 LOOK=PEEK(764) 

20 Print "KEY PRESSED = ";LOOK 

30 POKE 764,255 

40 For Loop=l To 250:Next Loop 

50 GoTo 10 

See COMPUTERS First Book of Atari for an example of using this 
register as a replacement for joystick input. 

765 2FD FILDAT 

Color data for the fill region in the XIO FILL command. 

766 2FE DSPFLG 

Display flag, used in displaying the control codes not associated 
with an ESC character (see location 674; $2A2). If zero is 
returned or POKEd here, then the ATASCII codes 27 -31,123 - 
127, 187 - 191 and 251 - 255 perform their normal display screen 
control functions (i.e., clear screen, Cursor movement, 
delete/insert line, etc.). If any other number is returned, then a 
control character is displayed (as in pressing the ESC key with 
CTRL-CLEAR for a graphic representation of a screen clear). 
POKEing any positive number here will force the display instead 
of the control code action. There is, however, a small bug, not 
associated with location 766, in Atari BASIC: a PRINTed CTRL-R 


84 
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or CTRL-U are both treated as a semicolon. 

767 2FF SSFLAG 

Start/stop display screen flag, used to stop the scrolling of the 
screen during a DRAW or graphics routine, a LISTing or a 
PRINTing. When the value is zero, the screen output is not 
stopped. When the value is 255 ($FF; the one's complement), the 
output to the screen is stopped, and the machine waits for the 
value to become zero again betöre continuing with the scrolling 
display. Normally SSFLAG is toggled by the user during these 
operations by pressing the CTRL-1 keys combination to both Start 
and stop the scroll. Set to zero by RESET and powerup. 


4.4 Page 3 

Locations 768 to 831 ($300 to $33F) are used for the device handler and vectors to the handler 
routines (devices S:, P:, E:, D:, C:, R: and K:). A device handler is a routine used by the OS to 
control the transfer of data in that particular device for the task allotted (such as read, write, save, 
etc.). The resident D: handler does not conform entirely with the other handler--SIO calling 
routines. Instead, you use the DCB to communicate directly with the disk handler. The device 
handler for R: is loaded in from the 850 interface module. See De Re Atari, the 850 Interface 
Manual, and the OS Listings pages 64 - 65. 

Locations 768 to 779 ($300 to $30B) are the resident Device Control Block (DCB) addresses, used 
for I/O operations that require the serial bus; also used as the disk DCB. DUP.SYS uses this block 
to interface the FMS with the disk handler. The Atari disk drive uses a serial access at 19,200 baud 
(about 20 times slower than the Apple!). It has its own microprocessor, a 6507, plus 128 bytes of 
RAM, a 2316 2K masked ROM Chip (like a 2716), a 2332 RAM-I/O timer Chip with another 128 
bytes of RAM (like the PIA Chip) and a WD 1771 FD Controller Chip. See the "Outpost Atari" 
column, Creative Computing, May 1982, for an example of using the disk DCB. 

All of the Parameters passed to SIO are contained in the DCB. SIO uses the DCB information and 
returns the Status in the DCB for subsequent use by the device handler. 


4 . 4.1 768 - 779 

DECIMAL HEX LABEL 

768 300 DDEVIC 

Device serial bus ID (serial device type) set up by the handler, 
not user-alterable. Values are: 

Disk drives Dl - D4 49-52 

Printer PI 64 

Printer P2 79 

RS232 ports R1-R4 80-83 

769 301 DUNIT 

Disk or device unit number: one to tour, set up by the user. 

770 302 DCOMND 

The number of the disk or device Operation (command) to be 
performed, set by the user or by the device handler prior to 
calling SIO. Serial bus commands are: 


Read 

82 

($52) 

Write (verily) 

87 

($57) 

Status 

83 

($53) 

Put (no verify) 

80 

(0) 

Format 

33 

($21) 

Download 

32 

($20) 


($31 — $34) 
($40) 
($4F) 
($50 — $53) 
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Read address 

84 

($54) 

Read spin 

81 

($51) 

Motor On 

85 

($55) 

Verify sector 

86 

($56) 


All of the above are disk device commands, except write and 
Status, which are also printer commands (with no verify). 

771 303 DSTATS 

The Status code upon return to user. Also used to set the data 
direction; whether the device is to send or receive a data frame. 
This byte is used by the device handler to indicate to SIO what to 
do after the command frame is sent and acknowledged. Prior to 
the SIO call, the handler examines BIT 6 (one equals receive 
data) and BIT 7 (one equals send data). If both bits are zero, then 
no data transfer is associated with the Operation. Both bits set to 
one is invalid. SIO uses it to indicate to the handler the Status of 
the requested Operation after the SIO call. 

772,773 304,305 DBUFLO/HI 

Data buffer address of the source or destination of the data to be 
transferred or the device Status Information (or the disk sector 
data). Set by the user, it need not be set if there is no data 
transferred, as in a Status request. 

774 306 DTIMLO 

The time-out value for the handler in one-second units, supplied 
by the handler for use by SIO. The cassette time-out value is 35, 
just over 37 seconds. The timer values are 64 seconds per 60 units 
of measurement. Initialized to 31. 

775 307 DUNUSE 

Unused byte. 

776,777 308,309 DBYTLO/HI 

The number of bytes transferred to or from the data buffer (or the 
disk) as a result of the most recent Operation, set by the handler. 
Also used for the count of bad sector data. There is a small bug in 
SIO which causes incorrect System actions when the last byte in a 
buffer is in a memory location ending with $FF, such as $A0FF. 

778,779 30A,30B DAUX1/2 

Used for device specific Information such as the disk sector 
number for the read or write Operation. Loaded down to locations 
572, 573 ($23C, $23D) by SIO. 

There are only five commands supported by the disk handler: 

GET sector (82; $52), PUT sector (80; $50), PUT sector with 
VERIFY (87; $57), STATUS request (83; $53) and FORMAT entire 
disk (33; $21). There is no command to FORMAT a portion of the 
disk; this is done by the INS 1771-1 formatter/controller Chip in 
the drive itself and isn't user-accessible. There is a new disk drive 
ROM to replace the current "C" Version. It is the "E" ROM. Not 
only is it faster than the older ROMs, but it also allows for 
selective formatting of disk sectors. Atari has not announced yet 
whether this new 810 ROM will be made available. For more 
information, see the OS User's Manual. 
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4 . 4.2 780 - 793 

Locations 780 to 793 ($30C to $319) are for miscellaneous use. Locations 794 to 831 ($31A to 
$33F) are handler address tables. To use these DCBs, the user must provide the required 
Parameters to this block and then do a machine language JSR to $E453 (58451) for disk I/O or 
$E459 (58457; the SIO entry point) for other devices. 

DECIMAL HEX LABEL 

780,781 30C,30D TIMER1 

Initial baud rate timer value. 

782 30E ADDCOR 

Addition correction flag for the baud rate calculations involving 
the timer registers. 

783 30F CASFLG 

Cassette mode when set. Used by SIO to control the program 
flow through shared code. When set to zero, the current 
Operation is a Standard SIO Operation; when non-zero, it is a 
cassette Operation. 

784,785 310,311 TIMER2 

Final timer value. Timer one and timer two contain reference 
times for the Start and end of the fixed bit pattern receive period. 

The first byte of each timer contains the VCOUNT value (54283; 

$D40B), and the second byte contains the current realtime clock 
value from location 20 ($14). The difference between the timer 
values is used in a lookup table to compute the interval for the 
new values for the baud rate passed on to location 750, 751 
($2EE, $2EF). 

786,787 312,313 TEMPI 

Two-byte temporary storage register used by SIO for the 
VCOUNT calculation during baud timer routines. See location 
54283 ($D40B). 

788 314 TEMP2 

Temporary storage register. 

789 315 TEMP3 

Ditto. 

790 316 SAVIO 

Save serial data-in port used to detect, and updated after, each 
bit arrival. Used to retain the state of BIT 4 of location 53775 
($D20F; serial data-in register). 

791 317 TIMFLG 

Time-out flag for baud rate correction, used to define an 
unsuccessful baud rate value. Initially set to one, it is 
decremented during the I/O Operation. If it reaches zero (after 
two seconds) betöre the first byte of the cassette record is read, 
the Operation will be aborted. 

792 318 STACKP 

SIO stack pointer register. Points to a byte in the stack being 
used in the current Operation (locations 256 to 511; $100 to $1 FF). 

793 319 TSTAT 

Temporary Status holder for location 48 ($30). 
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4 . 4.3 794 - 831 

DECIMAL HEX LABEL 

794-831 31A-33F HAT ABS 

Händler Address Table. Thirty-eight bytes are reserved for up to 
12 entries of three bytes per handler, the last two bytes being set 
to zero. On powerup, the HATABS table is copied from ROM. 
Devices to be booted, such as the disk drive, add their handler 
Information to the end of the table. Each entry has the character 
device name (C,D,E,K,P,S,R) in ATASCII code and the handler 
address (LSB/MSB). Unused bytes are all set to zero. FMS 
searches HATABS from the top for a device "D:" entry, and when 
it doesn't find it, it then sets the device vector at the end of the 
table to point to the FMS vector at 1995 ($7CB). CIO searches for 
a handler character from the bottom up. This allows new handlers 
to take precedence over the old. Pressing RESET clears HATABS 
of all but the resident handler entries! 


794 

31A 

Printer device 

ID 

<P :) , 

initialized To 58416 ($E430) 

797 

31D 

Cassette device 

ID 

(C:) 

, initialized To 58432 ($E440 

800 

320 

Display editor 

ID 

(E:) , 

initialized To 58368 ($E400) 

803 

323 

Screen handler 

ID 

(S :) , 

initialized To 58384 ($E410) 

806 

326 

Keyboard handler ID (K: 

($E420) . 

), initialized To 58400 


HATABS unused entry points: 

809 ($329), 812 ($32C), 815 ($32F), 818 ($332), 821 ($335), 824 
($338), 827 ($33B), and 830 ($33E). These are numbered 
sequentially from one to eight. There are only two bytes in the last 
entry (unused), both of which are set to zero. When DOS is 
present, it adds an entry to the table with the ATASCII code for 
the letter "D" and a vector to address 1995 ($7CB). 

The format for the HATABS table is: 

Device name 

Handler vector table address 
More entries 

Zero fill to the end of the table 

The device handler address table entry above for the specific 
handler points to the first byte (low byte/high byte) of the vector 
table which Starts at 58368 ($E400). Each handler is designed 
with the following format: 

Open vector 
Close vector 
Get Byte vector 
PUT Byte vector 
Get STATUS vector 
SPECIAL vector 

Jump To initialization code (JMP LSB/MSB) 

CIO uses the ZIOCB (see location 32; $20) to pass Parameters to 
the originating IOCB, the A, Y and X registers and CIO. It is 
possible to add your own device driver(s) to OS by following 
these rules: 

1) Load your routine, with necessary buffers at the address 
pointed to by MEMLO: location 743 ($2E7). 

2) Add the size of your routine to the MEMLO value and POKE 
the result back into MEMLO. 

3) Store the name and address of your driver in the handler 
address table; HATABS. 

4) Change the vectors so that the OS will re-execute the above 
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steps if RESET has been pressed. This is usually done by 
adjusting locations 12 ($C: DOSINIT) and 10 ($A; DOSVEC). 

See the "Insight: Atari" columns in COMPUTE!, January and 
April 1982, for details. The APX program "T: A Text Display 
Device" is a good example of a device handler application. 

See De Re Atari for more information on the DCB and HATABS, 
including the use of a null handler. 


4 . 4.4 832 - 959 

Locations 832 to 959 ($340 to $3BF) are reserved for the eight lOCB's (input/output control 
blocks). lOCB's are channels for the transfer of information (data bytes) into and out of the Atari, or 
between devices. You use them to teil the Computer what Operation to perform, how much data to 
move and, if necessary, where the data to be moved is located. Each block has 16 bytes reserved 
for it. 

What is an IOCB? Every time you PRINT something on the screen or the printer, every time you 
LOAD or SAVE a file, every time you OPEN a channel, you are using an IOCB. In some cases, 
operations have automatic OPEN and CLOSE functions built in-like LPRINT. In others, you must 
teil the Atari to do each step as you need it. Some lOCB’s are dedicated to specific use, such as 
zero for the screen display. Others can be used for any I/O function you wish. The information you 
place after the OPEN command teils CIO how you want the data transferred to or from the device. 
It is SIO and the device handlers that do the actual transfer of data. You can easily POKE the 
necessary values into the memory locations and use a machine language subroutine through a 
USR function to call 

the CIO directly (you must still use an OPEN and CLOSE Statement for the channel, however). 

This is useful because BASIC only supports either record or single byte data transfer, while the 
CIO will handle complete buffer I/O. See the CIO entry address, location 58454 ($E456), for more 
details. These blocks are used the same way as the page zero IOCB (locations 32 to 47; $20 to 
$2F). The OS takes the information here, moves it to the ZIOCB for use by the ROM CIO, then 
returns the updated information back to the user area when the Operation is done. Note that when 
BASIC encounters a DOS command, it CLOSEs all channels except zero. Refer to the Atari 
Hardware Manual and the 850 Interface Manual for more detailed use of these locations. 

DECIMAL HEX LABEL 

832-847 340-34F IOCBO 

I/O Control Block (IOCB) zero. Normally used for the screen 
editor (E:). You can POKE 838,166 and POKE 839,238 and send 
everything to the printer instead of to the screen (POKE 838,163, 
and POKE 839,246 to send everything back to the screen again). 

You could use this in a program to toggle back and forth between 
screen and printed copy when prompted by user input. This will 
save you multiple PRINT and LPRINT coding. 

You can use these locations to transfer data to other devices as 
well since they point to the address of the device’s "put one byte" 
routine. See the OS Manual for more information. Location 842 
can be given the value 13 for read from screen and 12 for write to 
screen. POKE 842,13 puts the Atari into "RETURN key mode" by 
setting the auxiliary byte one (ICAX1) to screen input and 
output. POKEing 842 with 12 returns it to keyboard input and 
screen output mode. The former mode allows for dynamic use of 
the screen to act upon commands the Cursor is made to move 
across. 

You can use this "forced read" mode to read data on the screen 
into BASIC without user Intervention. For example, in the 
program below, lines 100 through 200 will be deleted by the 
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program itself as it runs. 

10 GRAPHICS 0:P0SIT10N 2,4 
20 Print 100:Print 150:Print 200 
25 Print "CONT" 

30 POSITION 2,0 
50 POKE 842,13:STOP 
60 POKE 842,12 

70 REM THE Next LINES WILL BE DELETED 
100 Print "DELETING..." 

150 Print "DELETING..." 

200 Print "DELETED!" 

See COMPUTE!, August 1981, for a sample of this powerful 
technique. See Santa Cruz's Tricky Tutorial #1 (display lists) for 
another application. The last tour bytes (844 to 847; $34C to $34F 
in this case) are spare (auxiliary) bytes in all lOCB's. 

When you are in a GRAPHICS mode other than zero, channel 
zero is OPENed for the text window area. If the window is absent 
and you OPEN channel zero, the whole screen returns to mode 
zero. A BASIC NEW or RUN command closes all channels 
except zero. OPENing a channel to S: or E: always clears the 
display screen. 

See COMPUTE!, October 1981,for an example of using an IOCB 
with the cassette program recorder, and September 1981 for 
another use with the Atari 825 printer. 

848-863 350-35F IOCB1 

IOCB one. 

864-879 360-36F IOCB2 

IOCB two. 

880-895 370-37F IOCB3 

IOCB three. 

896-911 380-38F IOCB4 

IOCB tour. 

912-927 390-39F IOCB5 

IOCB five. 

928-943 3A0-3AF IOCB6 

IOCB six. The GRAPHICS Statement OPENs channel six for 
screen display (S:), so once you are out of mode zero, you cannot 
use channel six unless you first issue a CLOSE#6 Statement. If 
you CLOSE this channel, you will not be able to use the 
DRAWTO, PLOT or LOCATE commands until you reOPEN the 
channel. The LOAD command closes channel six; it also closes 
all channels except zero. 

944-959 3B0-3BF IOCB7 

IOCB seven. LPRINT automatically uses channel seven for its 
use. If the channel is OPEN for some other use and an LPRINT is 
done, an error will occur, the channel will be CLOSEd, and 
subsequent LPRINTs will work. The LIST command also uses 
channel seven, even if channel seven is already OPEN. However, 
when the LIST is done, it CLOSEs channel seven. The LOAD 
command uses channel seven to transfer programs to and from 
the recorder or disk. LIST (except to the display screen), LOAD 
and LPRINT also close all sound voices. The RUN from tape or 
disk and SAVE commands use channel seven, as does LIST. 

The bytes within each IOCB are used as follows: 
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Label Offset Bytes Description 


ICHID 0 1 Index into the device name 

fable for the currently OPEN file. Set by the OS. If not in use, the 

value is 255 ($FF), which is also the initialization value. 

ICDNO 1 1 Device number such as one 

for Dl: or two for D2:. Set by the OS. 

ICCOM 2 1 Command for the type of 

action to be taken by the device, set by the user. This is the first 
variable after the channel number in an OPEN command. See 
below for a command summary. Also called ICCMD. 

ICSTA 3 1 The most recent Status 

returned by the device, set by the OS. May or may not be the 
same value as that which is returned by the STATUS request in 
BASIC. See the OS User's Manual, pp. 165-166, fora list of Status 
byte values. 

ICBAL/H 4,5 2 Two-byte (LSB,MSB) buffer 

address for data transfer or the address of the file name for OPEN, 

STATUS, etc. 

ICPTL/H 6,7 2 Address of the device's put- 

one-byte routine minus one. Set by the OS at OPEN command, 
but not actually used by the OS (it is used by BASIC, however). 
Points to ClO's "IOCB NOT OPEN" message at powerup. 

ICBLL/H 8,9 2 Buffer length set to the 

maximum number of bytes to transfer in PUT and GET 
operations. Decremented by one for each byte transferred; 
updated after each READ or WRITE Operation. Records the 
number of bytes actually transferred in and out of the buffer after 
each Operation. 

ICAX1 10 1 Auxiliary byte number one, 

referred to as AUX1. Used in the OPEN Statement to specify the 
type of file access: four for READ, eight for WRITE, twelve for 
both (UPDATE). Not all devices can use both kinds of operations. 
This byte can be used in user-written drivers for other purposes 
and can be altered in certain cases once the IOCB has been 
OPENed (see the program example above). For the S: device, if 
AUX1 equals 32, it means inhibit the screen clear function when 
changing GRAPHICS modes. Bit use is as follows for most 
applications: 

Bit 7 6 5 4 3 2 1 0 
Use ....unused.... W R D A 

W equals write, R equals read, D equals directory, A equals 
append. 

ICAX2 11 1 Auxiliary byte two, referred 

to as AUX2. Special use by each device driver; some serial port 
functions may use this byte. Auxiliary bytes two to five have no 
fixed use; they are used to contain device-dependent and/or 
user-established data. 

ICAX3/4 12,13 2 Auxiliary bytes three and 

four; used to maintain a record of the disk sector number for the 

BASIC NOTE and POINT commands. 
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ICAX5 14 1 Auxiliary byte five. Used by 

NOTE and POINT to maintain a record of the byte within a sector. 
It Stores the relative displacement in sector from zero to 124 
($7C). Bytes 125 and 126 of a sector are used for sector-link 
values, and byte 127 ($7F) is used as a count of the number of 
data bytes in actual use in that sector. 

ICAX6 15 1 Spare auxiliary byte. 

Offset is the number you would add to the Start of the IOCB in 
Order to POKE a value into the right field, such as POKE 832 + 
OFFSET, 12. 

The following is a list of the values associated with OPEN 
Parameter number 1. Most of these values are listed in Your Atari 
400/800. These are the values found in ICAX1, not the ICCOM 
values. 

Device Task # Description 


Cassette 4 

recorder 8 


Read 

Write (can Do either, Not both) 


Disk 4 Read 

file 6 Read disk directory 

8 Write New file. Any file OPENed In 

this mode will be deleted, And the first Byte written will be at the 
Start of the file. 

9 Write— append. In this mode the 

file is left intact, And bytes written are put at the End of the file. 

12 Read And Write— update. Bytes 

Read Or written will Start at the first Byte In the file. 


D: If BIT 0 equals one And BIT 3 equals one In AUXl,Then 
Operation will be appended output. 


Screen 8 Screen Output 

editor 12 Keyboard Input And screen Output 

(E:) 13 Screen Input And Output 


E: BIT 0 equals one is a forced Read (Get command). 


Keyboard 

4 

Read 



Printer 

8 

Write 



RS-232 

5 

Concurrent 

Read 


serial 

8 

Block Write 


port 

9 

Concurrent 

Write 



13 

Concurrent 

Read And 

Write 



Clear 

Text 

Read 



Screen 

Window 

Oper¬ 



after GR. 

also 

ation 

Screen 

8 

yes 

no 

no 

display 

12 

yes 

no 

yes 

(S: ) 

24 

yes 

yes 

no 


28 

yes 

yes 

yes 


40 

no 

no 

no 


44 

no 

no 

yes 


56 

no 

yes 

no 


60 

no 

yes 

yes 


Note that with S:, the screen is always cleared in GR.O and there 
is no separate text window in GR.O unless specifically user- 
designed. Without the screen clear, the previous material will 
remain on screen between GRAPHICS mode changes, but will 
not be legible in other modes. The values with S: are placed in 
the first auxiliary byte of the IOCB. All of the screen values above 
are also a write Operation. 
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The second parameter in an OPEN Statement (placed in the 
second auxiliary byte) is far more restricted in its use. Usually set 
to zero. If set to 128 ($80) for the cassette, it changes from normal 
to short inter-record gaps (AUX2). 

With the Atari 820 printer, 83 ($53; AUX byte two) means 
sideways characters (Atari 820 printer only). Other printer 
variables (all for AUX2 as well) are: 70 ($4E) for normal 40 
character per line printing and 87 ($57) for wide printing mode. 
With the screen (S:), a number can be used to specify the 
GRAPHICS modes zero through eleven. If mode zero is chosen, 
then the AUX1 options as above are ignored. 

For the ICCOM field, the following values apply (BASIC XIO 
commands use the same values): 


Command 

Decimal 

Hex 


Open channel 

3 

3 


Get Text record (Line) 

5 

5 

BASIC: 
Input 
#n, A 

Get Binary record (buffer) 

7 

7 

BASIC: 

Get #n,A 

Put Text record (Line) 

9 

9 


Put Binary record (buffer) 

11 

B 

BASIC: 

PUT #n,A 

Close 

12 

c 


Dynamic (channel) Status 

13 

D 



BASIC uses a special "put byte" vector in the IOCB to talk 
directly to the handler for the PRINT#n,A$ command. 

Disk File Management System Commands (BASIC XIO 
command): 


Rename 

32 

20 


Erase (delete) 

33 

21 


Protect (Lock) 

35 

23 


Unprotect (unlock) 

36 

24 


Point 

37 

25 


Note 

38 

26 


Format 

254 

FE 


In addition, XIO Supports the following commands: 


Get character 

7 

7 


Put character 

11 

B 


Draw Line 

17 

11 

Display 
handler 
only. 

Fill area 

18 

12 

Display 
handler 
only. 

FILL is done in BASIC with XIO 18,#6,12,0, 

"S:" (see 

the BASIC 


Reference Manual for details). 


For the RS-232 (R:), XIO Supports: 


Output partial block 

32 

20 

Control RTS,XMT, DTR 

34 

22 

Baud, stop bits, word size 

36 

24 

Translation mode 

38 

26 

Concurrent mode 

40 

28 


(see the 850 Interface Manual for details) 

CIO treats any command byte value greater than 13 ($D) as a 
special case, and transfers control over to the device handler for 
Processing. For more Information on IOCB use, read Bill 
Wilkinson's "Insight: Atari" columns in COMPUTEI, November 
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and December 1981, and in Microcomputing, August 1982. Also 
refer to the OS User's Manual and De Re Atari. 


4 . 4.5 960 - 999 

DECIMAL HEX LABEL 

960-999 3C0-3E7 PRNBUF 

Printer buffer. The printer handler collects output from LPRINT 
Statements here, sending them to the printer when an End of Line 
(EOL; carriage return) occurs or when the buffer is full. Normally 
this is 40 characters. However, if an LPRINT Statement generates 
fewer than 40 characters and ends with a semicolon or 38 
characters and ends with a comma, Atari sends the entire buffer 
on each FOR-NEXT loop, the extra bytes filled with zeros. The 
output of the next LPRINT Statement will appear in column 41 of 
the same line. According to the Operating System User's 
Manual, the Atari supports an 80-column printer device called 
P2:. Using OPEN and PUT Statements to P2: may solve this 
Problem. Here is a small routine for a GR.O BASIC screen dump: 

10 Dim Text$ (1000): Open#2,4,0,"S:":TRAP 1050 


1000 For Line = 1 To 24: POSITION PEEK(82), Line 

1010 For COL = 1 To 38: Get#2,CHAR: Text$ (COL,COL)=CHR$(CHAR) 

1020 Next COL: Get#2,COL 

1030 LPRINT Text$ 

1040 Next Line 
1050 Return 

You can use the PTABW register at location 201 ($C9) to set the 
number of spaces between print elements separated by a comma. 
The minimum number of spaces accepted is two. LPRINT 
automatically uses channel seven for output. No OPEN Statement 
is necessary and CLOSE is automatic. 


4 . 4.6 1000 - 1020 

Locations 1000 to 1020 ($3E8 to $3FC) are a reserved spare buffer area. 


4.5 Page 4 - 5 

Locations 1152 to 1791 ($480 to $6FF) are for user RAM (outer environment) requirements, 
depending on the amount of RAM available in the machine. Provided you don't use the FP 
package or BASIC, you have 640 ($280) free bytes here. Locations 1152 to 1279 ($480 to $4FF) 
are 128 ($80) spare bytes. The floating point package, when used, requires locations 1406 to 1535 
($57E to $5FF). 

4 . 5.1 1021-1151 

DECIMAL HEX LABEL 

1021-1151 3FD-47F CASBUF 

Cassette buffer. These locations are used by the cassette handler 
to read data from and write data to the program (tape) recorder. 

The 128 ($80) data bytes for each cassette record are stored 
beginning at 1024 ($400 - page four). The current buffer size is 
found in location 650 ($28A). Location 61 ($3D) points to the 
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current byte being written or read. 

CASBUF is also used in the disk boot process; the first disk 
record is read into this buffer. 

A cassette record consists of 132 bytes: two control bytes set to 85 
($55; alternating zeros and ones) for speed measurement in the 
baud rate correction routine; one control byte (see below); 128 
data bytes (compared to 125 data bytes for a disk sector), and a 
checksum byte. Only the data bytes are stored in the cassette 
buffer. See De Re Atari for more -nformaUon on the cassette 
recorder. 


CONTROL BYTE VALUES 

Value Meaning 

250 ($FA) Partial record follows. The actual number of bytes is stored 
In the last Byte of the record (127) . 

252 ($FC) Record full; 128 bytes follow. 

254 ($FE) End of File (EOF) record; followed by 128 zero bytes. 


4 . 5.2 1152 - 1535 

DECIMAL HEX LABEL 

1406 57E LBPR1 

LBUFF prefix one. 

1407 57F LBPR2 

LBUFF prefix two. 

1408-1535 580-5FF LBUFF 

BASIC line buffer; 128 bytes. Used as an output result buffer for 
the FP to ASCII routine at 55526 ($D8E6). The input buffer is 
pointed to by locations 243, 244 ($F3, $F4). 

1504 5E0 PLYARG 

Polynomial arguments (FP use). 

1510-1515 5E6-5EB FPSCR 

FP scratch pad use. 

1516-1535 5EC-5FF FPSCR1 

Ditto. The end of the buffer is named LBFEND. 


4.6 Page 6 

Page six; protectet from OS 

4 . 6.1 1536 - 1791 


DECIMAL 

HEX 

LABEL 

1536-1791 

600-6FF 



Page six: 256 ($FF) bytes protected from OS use. Page six is not 
used by the OS and may be safely used for machine language 
subroutines, special I/O handlers, altered character sets, or 
whatever the user can fit into the space. Some problem may arise 
when the INPUT Statement retrieves more than 128 characters. 
The locations from 1536 to 1663 ($600 to $67F) are then 
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immediately used as a buffer for the excess characters. To avoid 
overflow, keep INPUT Statements from retrieving more than 128 
characters. The valFORTH implementation of fig-FORTH (from 
ValPar International) uses all of page six for its boot code, so it is 
not available for your use. However, FORTFI allows you to 
reserve other blocks of memory for similar functions. BASIC A+ 
uses locations $0600 - $67F. 


4.7 Page 7 

Locations 1792 to the address specified by LOMEM (locations 128, 129; ($80, $81) - the pointer to 
BASIC low memory) are also used by DOS and the File Management System (FMS). Refer to the 
DOS source code and Inside Atari DOS for details. The addresses which follow are those for DOS 
2.OS, the official Atari DOS at the time of this writing. Another DOS is available as an alternative to 
DOS 2.0 - K-DOS (TM), from K-BYTE (R). K-DOS is not menu driven but command driven. It 
does not use all of the same memory locations as the Atari DOS although it does use a modified 
Version of the Atari FMS. (Another command-driven DOS, called OS/A+, is completely compatible 
with DOS 2.OS and is available from OSS, the creators of DOS 2.OS.) 

DECIMAL HEX LABEL 

1792-5377 700-1501 

File management System RAM (pages seven to fifteen). FMS 
provides the interface between BASIC or DUP and the disk 
drive. It is a sophisticated device driver for all I/O operations 
involving the D: device. It allows disk users to use the special 
BASIC XIO disk commands (see the IOCB area 832 to 959: $340 
to $3BF). It is resident in RAM below your BASIC RAM and 
provides the entry point to DOS when called by BASIC. 

5440-13062 1540-3306 

DUP.SYS RAM. The top will vary with the amount of buffer 
storage space allocated to the drive and sector buffers. 

6780-7547 1A7C-1D7B 

Drive buffers and sector-data buffers. The amount of memory will 
vary with the number of buffers allocated. 

7548-MEMLO 1D7C-3306 (maximum) 

Non-resident portion of DUP.SYS, DOS Utility routines. DUP 
provides the Utilities chosen from the DOS menu page, not from 
BASIC. It is not resident in RAM when you are using BASIC or 
another cartridge; rather it is loaded when DOS is called from 
BASIC or on autoboot powerup (and no cartridge supersedes it). 

When DUP is loaded, it overwrites the lower portion of memory. 

If you wish to save your program from destruction, you must have 
created a MEM.SAV file on disk betöre you called DOS from your 
program. See the DOS Reference Manual. 


4 . 7.1 1792-2047 


Locations 1792 to 2047 ($700 to $7FF; page seven) are the user boot area. MEMLO and LOMEM 
point to 1792 when no DOS or DUP program is loaded. This area can then be used for your BASIC 
or machine language programs. The lowest free memory address is 1792, and programs may 
extend upwards from here. There is a one-page buffer betöre the program space used for the 
tokenization of BASIC Statements, pointed to by locations 128, 129 ($80, $81). Actually a program 
may Start from any address above 1792 and below the screen display list as long as it does not 
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overwrite this buffer if it is a BASIC program. Also, 1792 is the Start of the FMS portion of DOS 
when resident. 

When Software is booted, the MEMLO pointer at 743,744 ($2E7,$2E8) in the OS data base 
(locations 512 to 1151; $512 to $47F) points to the first free memory location above that Software; 
otherwise, it points to 1792. The DUP portion of DOS is partly resident here, starting at 5440 
($1540) and running to 13062 ($1540 to $3306). The location of the OS disk boot entry routine 
(DOBOOT) is 62189 ($F2ED). The Standard Atari DOS 2.OS takes up sectors one through 83 
($53) on a disk. Sector one is the boot sector. Sectors two through 40 ($28) are the FMS portion, 
and sectors 41 ($29) through 83 are the DUP.SYS portion of DOS. For more information, see the 
DOS and OS source listings and Inside Atari DOS. 


FMS, DOS.SYS and DUP.SYS 

Disk boot records (sector one on a disk) are read into 1792 ($700). 
Starting from $700 (1792), the format is: 


Byte 

0 

1 


2,3 

4,5 

6 


Hex 

700 

701 


702,703 
704,705 
706 


Label And use 

BFLAG: Boot flag equals zero (unused). 

BRCNT: Number of consecutive sectors To 
Read (If the file is DOS, Then BRCNT equals 
one) . 

BLDADR: Boot sector load address ($700) . 
BIWTARR: Initialization address. 

JMP XBCONT: Boot continuation vector; $4C 


(76): JMP command To Next address In bytes seven And eight. 


7,8 707,708 Boot Read continuation address 

(LSB/MSB). 

9 709 SABYTE: Maximum number of concurrently 

Open files. The default is three (see 1801 below). 


10 70A DRVBYT: Drive bits: the maximum number 

of drives attached To the System. The default is two (see 1802 
below). 

11 70B (unused) Buffer allocation direction, Set To 

zero. 

12,13 70C,70D SASA: Buffer allocation Start address. Points 

To 1995 ($7CB) when DOS is loaded. 


14 70E DSFLG: DOS flag. Boot flag Set To non-zero 

Must be non-zero For the second phase of boot process. Indicates 
that the file DOS.SYS has been written To the disk; zero equals no 
DOS file, one equals 128 Byte sector disk, two equals 256 Byte 
sector disk. 


15,16 70F,710 DFLINK: Pointer To the first sector of DOS.SYS 

file. 

17 711 BLDISP: Displacement To the sector link Byte 

125 ($7D) . The sector link Byte is the pointer To the Next disk 
sector To be read. If it is zero, the End of the file has been 
reached. 


18,19 712,713 DFLADR: Address of the Start of DOS.SYS 

file. 

20+ 714+ Continuation of the boot load file. See the 

OS User's Manual and Chapter 20 of Inside Atari DOS. 


Data from the boot sector is placed in locations 1792 to 1916 ($700 
to $77C). Data from the rest of DOS.SYS is located starting from 
1917 ($77D). All binary file loads Start with 255 ($FF). The next 
four bytes are the Start and end addresses (LSB/MSB), 
respectively. 

1801 709 SABYTE 

This records the limit on the number of files that can be open 
simultaneously. Usually set to three, the maximum is seven (one 
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for each available IOCB - remember IOCBO is used for the 
screen display). Each available file takes 128 bytes for a buffer, 
if you increase the number of buffers, you decrease your RAM 
space accordingly. You can POKE 1801 with your new number to 
increase or decrease the number of files and then rewrite DOS 
(by calling DOS from BASIC and choosing menu selection "H") 
and have this number as your default on the new DOS. 

1802 70A DRVBYT 

The maximum number of disk drives in your System, the DOS 2.0 
default value is two. The least four bits are used to record which 
drives are available, so if you have drives one, three and four, 
this location would read: 

00001101 or 13 in decimal. 

Each drive has a separate buffer of 128 bytes reserved for it in 
RAM. If you have more or less than the default (two), then POKE 
1802 with the appropriate number: 

1 drive = 1 BIT 0 Binary 00000001 

2 drives = 3 BITS 0 & 1 00000011 

3 drives = 7 BITS 0, 1 & 2 00000111 

4 drives = 15 BITS 0, 1, 2 & 3 00001111 

This assumes you have them numbered sequentially. If not, 

POKE the appropriate decimal translation for the correct binary 
code: each drive is specified by one of the least four bits from one 
in BIT 0 to four in BIT 3. If you PEEK (1802) and get back three, 
for example, it means drives one and two are allocated, not three 
drives. 

You can save your modification to a new disk by calling up DOS 
and choosing menu selection "H." This new DOS will then boot 
up with the number of drives and buffers you have allocated. A 
one-drive System can save 128 bytes this way (256 if one less data 
buffer is chosen). See the DOS Manual, page G.87. 

1900 76C BSIO 

Entry point to FMS disk sector I/O routines. 

1906 772 BSIOR 

Entry point to the FMS disk handler (?). 

1913 779 

Write verify flag for disk I/O operations. POKE with 80 ($50) to 
turn off the verify function, 87 ($57) to turn it back on. Disk write 
without verify is faster, but you may get errors in your data. I 
have had very few errors generated by turning off the verify 
function, but even one error in critical material can destroy a 
whole program. Be careful about using this location. You can 
save DOS (as above with menu selection "H") without write verify 
as your new default by writing DOS to a new disk. See the DOS 
Manual, page F.85. K-DOS's write-verify flag is located at 1907 
($773). 

1995 7CB DFMSDH 

Entry point to a 21-byte FMS device (disk) handler. The address 
of this handler is placed in HATABS (locations 794 to 831; $31A 
to $33F) by the FMS initialization routine. When CIO needs to 
call an FMS function, it will locate the address of that function via 
the handler address table. See Chapters 8-11 of Inside Atari 
DOS, published by COMPUTE! Books. 
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2016 7E0 DINT 

FMS initialization routine. The entry point is 1995 ($7CB). DUP 
calls FMS at this point. K-DOS uses the same location for its 
initialization routine. 


4.8 Page 8 - ff 

System routines 

4.8.1 2048-8191 

DECIMAL HEX LABEL 

2219 8AB DFMOPN 

OPEN routines, including open for append, update, and output. 

2508 900 DFMPUT 

PUT byte routines. 

2591 AI F WTBUR 

Burst I/O routines. 

2592-2773 A20-AD5 

In COMPUTER May and July 1982, Bill Wilkinson discussed 
BURST I/O, which should not take place when a file is OPEN for 
update, but does, due to a minor bug in DOS 2.0 (see also Inside 
Atari DOS, Chapter 12). This will cause update writes to work 
properly, but update reads to be bad. The following POKEs will 
correct the problem. Remember to save DOS back to a new disk. 

POKE 2592,130 ($A20,82) 

POKE 2593, 19 ($A21,13) 

POKE 2594,73 ($A22,49) 

POKE 2595,12 ($A23,0C) 

POKE 2596,240 ($A24,F0) 

POKE 2597,36 ($A25,24) 

POKE 2598, 106 ($A26,6A) 

POKE 2599,234 ($A27,EA) 

POKE 2625,16 ($A41,10) 

POKE 2773,31 ($AD5,1F) 

(Note that the July 1982 issue of COMPUTE! contained a typo 
where the value to be POKEd into 2773 was mistakenly listed as 
13, not 31!) Wilkinson points out that one way to completely 
disable BURST I/O (useful in some circumstances such as using 
the DOS BINARY SAVE to save the contents of ROM to disk!) is 
by: 

POKE 2606,0 ($A2E,0) 

This, however, will make the System LOAD and SAVE files 
considerably more slowly, so it's not recommended as a 
permanent change to DOS. 

2751 ABF DFMGET 

GET byte routines, including GET file routines. 

2817 BOI DFMSTA 
Disk STATUS routines. 

2837 Bl 5 DFMCLS 

IOCB CLOSE routines. 
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2983 BA7 DFMDDC 

Start of the device-dependent command routines, including the 
BASIC XIO special commands: 

3033 BD9 XRENAME 

RENAME afile. 

3122 C32 XDELETE 

DELETE afile. 

3196 C7C XLOCK, XUNLOCK 

LOCK and UNLOCK files. UNLOCK routines begin at 3203 
($C83). 

3258 CBA XPOINT 

BASIC POINT command. 

3331 D03 XNOTE 

BASIC NOTE command. See the DOS Manual for information 
regarding these two BASIC commands, and see De Re Atari for a 
sample use. 

3352 Dl 8 XFORMAT 

Format the entire diskette. 

3501 DAD LISTDIR 

List the disk directory. 

3742 E9E FNDCODE 

File name decode, including wildcard validity test. The current 
file name is pointed to by ZBUFP at locations 67, 68 ($43, $44). 

3783 EC7 

By POKEing the desired ATASCII value here, you can change 
the wildcard character (*; ATASCII 42, $2A) used by DOS to any 
other character of your choice. Your altered DOS can be saved 
back to disk with DOS menu selection "H". 

3818,3822 EEA,EEE 

By POKEing 3818 with 33 and 3822 with 123 ($21 ,$7B;), you can 
modify DOS to accept file names with punctuation, numbers and 
lowercase as valid; 33 is the low ränge of the ATASCII code and 
127 the high ränge (lower or higher values are control and 
graphics codes and inverse characters). Of course, any 
unmodified DOS still won't accept such file names. You could 
actually change the ränge to any value from zero to 255 at your 
discretion. This, however, may cause other problems with such 
ATASCII codes as spaces and the wildcard (*; see above). Can 
be saved back to disk with menu selection "H". 

3850 F0A FDSCHAR 

Store the file name characters that result from the file name 
decode routines. 

3873 F21 SFDIR 

Directory search routines; search for the user-specified file 
name. 

3988 F94 WRTNXS 

Write data sector routine. 
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4111 100F RDNXTS 

Read data sector routine. 

4206 106E RDDIR 

Read and write directory sector routines. 

4235 108B RDVTOC 

Read or write the volume table of contents (VTOC) sectors. 

4293 10C5 FRESECT 

Free sector(s) routine; returns the number of free sectors on a 
disk that are available to the user. 

4358 1106 GETSECTOR 

Get sector routine; retrieves a free sector for use from the disk. 

4452 1164 SETUP 

SETUP -- initialization of the FMS Parameters. Prepares FMS to 
deal with the Operation to be performed and to access a 
particular file. See Inside Atari DOS, Chapter seven. 

4618 120A WRTDOS 

Write new DOS.SYS file to disk routine, including new FMS file 
to DOS.SYS file. 

4789 12B5 ERRNO 

Start of the FMS error number table. 

4856-4978 12F8-1372 

Miscellaneous FMS storage area: sector length, drive tape, stack 
level, file number, etc. 

4993-5120 1381-1400 FCB 

Start of the FMS File Control Blocks (FCB's). FCB's are used to 
störe information about files currently being processed. The 
eight FCB’s are 16-byte blocks that correspond in a one-on-one 
manner with the lOCB's. Each FCB consist of: 

Label Bytes Purpose 

FCBFNO 1 File number of the current file being 
processed. 

FCBOTC 1 Which mode the file has been OPENed for: 
append is one, directory read is two, input is four, output is 
eight, update is twelve. 

SPARE 1 Not used. 

FCBSLT 1 Flag for the sector length type; 128 or 256 
bytes 

FCBFLG 1 Working flag. If equal to 128 ($80), then the 
file has been OPENed for output or append and may acquire new 
data sectors. If the value is 64, then sector is in the memory buffer 
awaiting writing to disk. 

FCBMLN 1 Maximum sector data length; 125 or 253 bytes 
depending on drive type (single or double density). The last 
three sector bytes are reserved for sector link and byte count 
data. 
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FCBDLN 1 Current byte to be read or modified in the 
Operation in a data sector. 

FCBBUF 1 Teil FMS which buffer has been allocated 
to the file being processed. 

FCBCSN 2 Sector number of the sector currently in the 
buffer. 

FCBLSN 2 Number of the next sector in data Chain. 

FCBSSN 2 Starting sectors for appended data if the file 

has been OPENed for append. 

FCBCNT 2 Sector count for the current file. 

DUP doesn't use these FCB’s; it writes to the lOCB’s directly. 

CIO transfers the control to FMS as the Operation demands, then 
on to SIO. 

5121 1401 FILDIR 

File directory, a 256 ($100) byte sequential buffer for entries to 
the disk directory. 

5377 1501 ENDFMS 

Disk directory (VTOC - Volume Table Of Contents) buffer. 64 
($40) bytes are reserved, one byte for each possible file. It also 
marks the end of FMS. The VTOC (sector 360; $168) is a 
sequential bit map of each of the 720 sectors on the disk. It Starts 
at byte ten and continues through to byte 99. When a bit is set 
(one), it indicates that the sector associated is in use. 

5440 1540 DOS 

DUP.SYS initialization address. Beginning of mini-DOS; the 
RAM-resident portion of DUP. Used for the same purpose in K- 
DOS. 

5446,5450 1546,154A 

Contains the location (LSB/MSB) of the DOS VEC (location 10; 
$A). This is the pointer to the address BASIC will jump to when 
DOS is called. 

5533 159D DUPFLG 

Flag to test if DUP is already resident in memory. Zero equals 
DUP is not there. 

5534 159E OPT 

Used to störe the value of the disk menu Option chosen by the 
user. 

5535 159F LOADFLG 

If this location reads 128, then a memory file (MEM.SAV) file 
doesn't have to be loaded. 

5540 15A4 SFLOAD 

Routines to load a MEM.SAV file if it exists. 

5888 1700 USRDOS 

Listed in the DUP.SYS equates file but never explained in the 
listings. 
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5899 170B MEMLDD 

Flags that the MEM.SAV file has been loaded. Zero means it has 
not been loaded. 

5947 173B 

The MEM.SAV (MEMSAVE) file creation routines begin here. 

They Start with the file name MEM.SAV stored in ATASCII 
format. The write routines begin at MWRITE, 5958 ($1746). The 
DOS Utility MEMSAVE copies the lower 6000 bytes of memory to 
disk to save your BASIC program from being destroyed when 
you call DOS, which then loads DUP.SYS into that area of 
memory. 

6044,6045 179C-179D INISAV 

DOSINI (see location 12, 13; $C, $D) vector save location. Entry 
point to DOS on a call from BASIC. 

6046 179E MEMFLG 

Flag to show if memory has been written to disk using a 
MEM.SAV file. 

6418 1912 CLMJMP 

Test to see if DOS must load MEM.SAV from the disk betöre it 
does a run at cartridge address, then jumps to the cartridge 
address. 

6432 1920 LMTR 

Test to see if DOS must load MEM.SAV betöre it performs a run at 
address command from the DOS menu. 

6457 1939 LDMEM 

MEMSAVE load routines (for the MEM.SAV file). 

6518 1979 INITIO 

DUP.SYS Warmstart entry. An excellent program to eliminate the 
need for DUP.SYS and MEM.SAV (not to mention the time 
required to load them!) was presented in COMPUTER July 1982, 
called MicroDOS; it's well worth examining. See also "The Atari 
Wedge," COMPUTER December 1982. 

663C 19E6 ISRODN 

Start of the serial Interrupt Service routine to output data needed 
routines in DUP.SYS. 

6691 1A23 ISRSIR 

Start of the serial interrupt ready Service routines in DUP.SYS. 

6781 1A7D 

Start of the drive and data buffers. Drive buffers are numbered 
sequentially one to four, data buffers one to eight, assuming that 
many are allocated for each. Normally, the first two buffers are 
allocated for drives and the next three for data. Buffers are 128 
($80) bytes long each and Start at 6908 ($1AFC), 7036 ($1B7C), 

7162 ($1 BFA) and 7292 ($1C7C). See locations 1801 and 1802 
($709, $70A). 

7420 1CFC 

MEMLO (743, 744; $2E7, $2E8) points here when DOS is resident 
unless the buffer allocation has been altered. MEMLO will point 
to 7164 for a one drive, two data buffer setup, a saving of 256 
bytes. Loading the RS-232 handler from the 850 Interface will 
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move MEMLO up another 1728 bytes. The RS-232 handler in the 
850 Interface will only boot (load into memory) if you first boot 
the AUTORUN.SYS file on your Atari master diskette or use 
another RS-232 boot program such as a terminal package. The 
RS-232 handler will boot up into memory if you do not have a disk 
attached and you have turned it on betöre turning on the 
Computer. You may still use the printer (parallel) port on the 850 
even if the RS-232 handler is not booted. 

7548 1D7C 

Beginning of non-resident portion of DUP; 40 ($28) byte 
Parameter buffer. 

7588 1DA4 LINE 

80 ($50) byte line buffer. 

7668 1DF4 DBUF 

256 ($100) byte data buffer for COPY routines. Copy routines 
work in 125-byte passes, equal to the number of data bytes in 
each sector on the disk. There are 256 bytes because Atari had 
planned a double density drive which has 253 data bytes in each 
sector. 

7924 1EF4 

Miscellaneous variable storage area and data buffers. 

7951-8278 1F0F-2056 DMENU 

Disk menu screen display data is stored here. 

8191 1 FFF 

This is the top of the minimum RAM required for Operation (8K). 
To use DOS, you must have a minimum of 16K. 


4 . 8.2 8192-32767 

DUP.SYS ROUTINES 

Locations 8192 to 32767 ($2000 to $7FFF) are the largest part of the RAM expansion area; this 
space is generally for your own use. If you have DOS.SYS or DUP.SYS loaded in, they also use a 
portion of this area to 13062 ($3306) as below: 

DECIMAL HEX LABEL 

8309 2075 DOSOS 

Start of the DOS utility monitor, including the Utilities called 
when a menu selection function is completed and the display of 
the "SELECT ITEM" message. 

8505 2139 DIRLST 

Directory listing. 

8649 21C9 DELFIL 

Delete a file. 

8990 231E 

Copy a file. This area Starts with the copy messages. The copy 
routines themselves begin at PYFIL, 9080 ($2378). 

9783 2637 RENFIL 

Rename a disk file routines. 
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9856 2680 FMTDSK 

Format the entire disk. There is no way to format specific sectors 
of a disk with the "C" ROMs currently used in your 810 drives. 
There is a new ROM, the "E" Version, which not only allows 
selective sector formatting, but is also considerably faster. It was 
not known at the time of this writing whether Atari would release 
the "E" Version. 

9966 26EE STCAR 

Start a cartridge. 

10060 274C BRUN 

Run a binary file at the user-specified address. 

10111 277F 

Start of the write MEM.SAV file to disk routine. The entry point is 
at MEMSAV, 10138 ($279A). 

10201 27D9 WBOOT 

Write DOS/DUP files to disk. 

10483 28F3 TESTVER2 

Test for Version two DOS. DOS.20S is the latest official DOS, 
considerably improved over the earlier DOS 1.0. The S Stands for 
single density. Atari had planned to release a dual density drive 
(the 815), but pulled it out of the production line at the last minute 
for some obscure high-level reason. A double density drive is 
available from the Percom Company. 

10522 291A LDFIL 

Load a binary file into memory. If it has a run address specified in 
the file, it will autoboot. 

10608 2970 LKFIL, ULFIL 

Lock and unlock files on a disk. 

10690 29C2 DDMG 

Duplicate a disk. 

11528 2D08 DFFM 

Duplicate a file. 

11841 2E41 

Miscellaneous subroutines. 

12078 2F2E SAVFIL 

Save a binary file. 

12348 303C 

Miscellaneous subroutines. 

13062 3306 

End of DUP.SYS. 

The rest of RAM is available to location 32767 ($7FFF). 
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4 . 8.3 32768 - 40959 

CARTRIDGE B: 8K 

Locations 32768 to 40959 ($8000 to $9FFF) are used by the right Cartridge (Atari 800 only), when 
present. When not present, this RAM area is available for use in programs. When the 8K BASIC 
cartridge is being used, this area most frequently contains the display list and screen memory. As 
of this writing, the only cartridge that uses this slot is Monkey Wrench from Eastern House 
Software. 


It is possible to have 16K Cartridges on the Atari by either combining both slots using two 8K 
Cartridges or simply having one with large enough ROM Chips and using one slot. In this case, the 
entire area from 32768 to 49151 ($8000 to $BFFF) would be used as cartridge ROM. 

Technically, the right cartridge slot is checked first for a resident cartridge and initialized, then the 
left. You can confirm this by putting the Assembler Editor cartridge in the right and BASIC in the left 
slots. BASIC will boot, but not the ASED. Using FRE(0), you will see, however, that you have 8K 
less RAM to use; and PEEKing through this area will show that the ASED program is indeed in 
memory, but that control was passed to BASIC. Control will pass to the ASED cartridge if the 
cartridges are reversed. This is because the last six bytes of the cartridge programs teil the OS 
where the program begins -- in both cases, it is a location in the area dedicated to the left cartridge. 
The six bytes are as follows: 


Byte 
Left (A) 

49146 ($BFFA) 

49147 ($BFFB) 

49148 ($BFFC) 


Purpose 
Right(B) 

40954 ($9FFA) Cartridge Start address (low byte) 

40955 ($9FFB) Cartridge Start address (high byte) 
40956,($9FFC) Reads zero if a cartridge is 

inserted, non-zero when no cartridge is present. This information 
is passed down to the page zero RAM: if the A cartridge is plugged 
in, then location 6 will read one; if the B cartridge is plugged in, 
then location 7 will read one; otherwise they will read zero. 

49149 ($BFFD) 40957 ($9FFD) Option byte. If BIT 0 equals one, 

then boot the disk (eise there is no disk boot). If BIT 2 equals one, 
then initialize and Start the cartridge (eise initialize but do not 

Start). If BIT 7 equals one, then the cartridge is a diagnostic 
cartridge which will take control, but not initialize the OS (eise 
non-diagnostic cartridge). Diagnostic cartridges were used by 
Atari in the development of the System and are not available to the 
public. 

49150 ($BFFE) 40958 ($9FFE) Cartridge initialization address 

low byte. 

49151 ($BFFF) 40959 ($9FFF) Cartridge initialization address 

high byte. This is the address to which the OS will jump during all 
powerup and RESETs. 


The OS makes temporary use of locations 36876 to 36896 ($900C to 
$9020) to set up vectors for the Interrupt handler. See the OS 
listings pages 31 and 81. This code was only used in the 
development System used to design the Atari. 


4 . 8.4 40960-49151 

CARTRIDGE A: 8K 

Locations 40960 to 49151 ($A000 to $BFFF) are used by the left cartridge, when present. When 
not present, this RAM area is available for other use. The display list and the screen display data 
will be in this area when there is no cartridge present. 

Most cartridges use this slot (see above) including the 8K BASIC, Assembler-Editor, and many 
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games. Below are some of the entry points for the routines in Atari 8K BASIC. There is no official 
Atari listing of the BASIC ROM yet. Many of the addresses below are listed in Your Atari 400/800. 
Others have been provided in numerous magazine articles and from disassembling the BASIC 
cartridge. 

BASIC ROUTINES 

40960-41036 A000-A04C 
Cold Start. 

41037-41055 A04D-A05F 
Warm Start. 

41056-42081 A060-A461 

Syntax checking routines. 

42082-42158 A462-A4AE 
Search routines. 

42159-42508 A4AF-A60C 

STATEMENT name table. The Statement TOKEN list begins at 42161 ($A4B1). You can print a list 
of these tokens by: 

5 ADDRESS = 42161 

10 If Not PEEK(ADDRESS) Then Print :End 
15 Print TOKEN, 

20 Byte = PEEK(ADDRESS): ADDRESS = ADDRESS + 1 
30 If Byte < 128 Then Print CHR$(BYTE);: GoTo 20 
40 Print CHR$ (Byte - 128) 

50 ADDRESS = ADDRESS + 2: TOKEN = ToKEN + 1: GoTo 10 

42509-43134 A60D-A87E 

Syntax tables. The OPERATOR token list begins at 42979 ($A7E3). You can print a list of these 
tokens by: 

5 ADDRESS = 42979: TOKEN = 16 

10 If Not PEEK (ADDRESS) Then Print :End 

15 Print TOKEN, 

20 Byte = PEEK(ADDRESS): ADDRESS = ADDRESS + 1 
30 If Byte < 128 Then Print CHR$(BYTE);: GoTo 20 
40 Print CHR$ (Byte - 128) 

50 TOKEN = TOKEN + 1 
60 GoTo 10 

See COMPUTER January and February 1982; BYTE, February 1982, and De Re Atari for an 
explanation of BASIC tokens. 

43135-43358 A87F-A95E 
Memory manager. 

43359-43519 A95F-A9FF 
Execute CONT Statement. 

43520-43631 AA00-AA6F 
Statement table. 

43632-43743 AA70-AADF 
Operator table. 

43744-44094 AAE0-AC3E 
Execute expression routine. 

44095-44163 AC3F-AC83 
Operator precedence routine. 
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44164-45001 AC84-AFC9 
Execute operator routine. 

45002-45320 AFCA-B108 
Execute function routine. 

45321-47127 B109-B817 

Execute Statement routine. 

47128-47381 B818-B915 

CONT Statement subroutines. 

47382-47542 B916-B9B6 

Error handling routines. 

47543-47732 B9B7-BA74 

Graphics handling routines. 

47733-48548 BA75-BDA4 
I/O routines. 

48549-49145 BDA5-BFF9 
Floating point routines (see below). 

48551 BDA7 SIN 

Calculate SIN(FRO). Checks DEGFLG (location 251; $FB) to see if 
trigonometric calculations are in radians (DEGFLG equals zero) 
or degrees (DEGFLG equals six). 

48561 BDB1 COS 

Calculate Cosine (FR0) with carry. FR0 is Floating Point register 
zero, locations 212-217; $D4-$D9. See the Floating Point package 
entry points from location 55296 on. 

48759 BE77 ATAN 

Calculate Atangent using FR0, with carry. 

48869 BEE5 SQR 

Calculate square root (FR0) with carry. 

Note that there is some conflict of addresses for the above 
routines. The addresses given are from the first edition of De Re 
Atari. The Atari OS Source Code Listing gives the following 
addresses for these FP routines: 

These are entry points, not actual Start addresses. 

SIN 48513 ($BD81) 

COS 48499 ($BD73) 

ATAN 48707 ($BE43) 

SQR 48817 ($BEB1) 

However, after disassembling the BASIC ROMs, I found that the 
addresses in De Re Atari appear to be correct. 

49146,7 BFFA,B 

Left cartridge Start address. 

49148 BFFC 

A non-zero number here teils the OS that there is no cartridge in 
the left slot. 

49149 BFFD 

Option byte. A cartridge which does not specify a disk boot may 
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use all of the memory from 1152 ($480) to MEMTOP any way it sees 
fit. 

49150,1 BFFE,F 

Cartridge initialization address. See the above section on the right 
slot, 32768 to 40959, for more information. 


When a BASIC program is SAVEd, only 14 of the more than 50 
page zero locations BASIC uses are written to the disk or cassette 
with the program. The rest are all recalculated with a NEW or 
SAVE command, sometimes with RUN or GOTO. These 14 


locations are 



128,129 

80,81 

LOMEM 

130,131 

82,83 

VNTP 

132,133 

84,85 

VNTD 

134,135 

86, 87 

VVTP 

136,137 

88,89 

STMTAB 

138,139 

8A, 8B 

STMCUR 

140,141 

8C, 8D 

STARP 


The string/array space is not loaded; STARP is included only to 
point to the end of the BASIC program. 

The two other critical BASIC page zero pointers, which are not 
SAVEd with the program, are: 

142,143 8E,8F RUNSTK 
144,145 90,91 MEMTOP 

For more information concerning Atari BASIC, see the appendix. 
For detailed description, refer to the Atari BASIC Reference 
Manual. For more technical information, see De Re Atari, BYTE, 
February 1982, and COMPUTERS First Book of Atari and 
COMPUTERS Second Book of Atari. 


4.8.5 49152-53247 

Locations 49152 to 53247 ($C000 to $CFFF) are unused. 

Unfortunately, this rather large 4K block of memory cannot be written to by the user, so it is 
presently useless. Apparently, this area of ROM is reserved for future expansion. Rumors abound 
about new Atari OS's that allow 3-D graphics, 192K of on-board RAM and other delights. Most 
likely this space will be consumed in the next OS Upgrade. PEEKing this area will show it not to be 
completely empty; it was apparently used for System development in Atari's paleozoic age. 

Although the Atari is technically a 64K machine (1K equals 1024 bytes, so 64K equals 65536 
bytes), you don't really have all 64K to use. The OS takes up 10K; there is the 4K block here that's 
unused, plus a few other unused areas in the ROM and, of course, there are the hardware Chips. 
BASIC (or any cartridge) uses another 8K. The bottom 1792 bytes are used by the OS, BASIC, and 
floating point package. Then DOS and DUP take up their memory space, not to mention the 850 
handler if booted - leaving you with more or less 38K of RAM to use for your BASIC programming. 


4.8.6 53248 - 55295 I/O Chips 

Locations 53248 to 55295 ($D000 to $D7FF) are for ROM for the special I/O Chips that Atari uses. 
The CTIA (or GTIA, depending on which you have) uses memory locations 53248 to 53503 ($D000 
to $D0FF). POKEY uses 53760 to 54015 ($D200 to $D2FF). PIA uses 54016 to 54271 ($D300 to 
$D3FF). ANTIC uses 54272 to 54783 ($D400 to $D5FF). ANTIC, POKEY and G/CTIA are Large 
Scale Integration (LSI) Circuit Chips. Don't confuse this Chip ROM with the OS ROM which is be 
found in higher memory. For the most extensive description of these Chips, see the Atari Hardware 
Manual. 

There are two blocks of unused, unavailable memory in the I/O areas: 53504 to 53759 ($D100 to 


Converted and layouted 2006 by Andreas Bertelmann for ABBUC 








Memory map 110 


$D1 FF) and 54784 to 55295 ($D600 to $D7FF). 

Many of the following registers can't be read directly, since they are hardware registers. Writing to 
them can often be difficult because in most cases the registers change every 30th second (stage 
two VBLANK) or even every 60th second (stage one VBLANK)! That's where the shadow registers 
mentioned earlier come in. The values written into these ROM locations are drawn from the 
shadow registers; to effect any "permanent" change in BASIC (i.e., while your program is running), 
you have to write to these shadow registers (in direct mode or while your program is running; these 
values will all be reset to their initialization state on RESET or powerup). 

Shadow register locations are enclosed in parentheses; see these locations for further 
descriptions. If no shadow register is mentioned, you may be able to write to the location directly in 
BASIC. Machine language is fast enough to write to the ROM locations and may be able to bypass 
the shadow registers entirely. 

Another feature of many of these registers is their dual nature. They are read for one value and 
written to for another. The differences between these functions are noted by the (R) for read and 
(W) for write functions. You will notice that many of these dual-purpose registers also have two 
labels. 


4.8.6.1 53248 - 53279 (GTIA or CTIA) 

CTIA or GTIA 

DECIMAL HEX LABEL 

53248-53505 D000-D0FF 

GTIA (or CTIA) is a special television interface Chip designed 
exclusively for the Atari to process the Video Signal. ANTIC 
Controls most of the C/GTIA Chip functions. The GTIA shifts the 
display by one-half color clock off what the CTIA displays, so it 
may display a different color than the CTIA in the same piece of 
Software. However, this shift allows players and playfields to 
overlap perfectly. 

There is no text window available in GTIA modes, but you can 
create a defined area on your screen with either a DLI (see 
COMPUTEI, September 1982) or by POKEing the GTIA mode 
number into location 87 ($57), POKEing 703 with four and then 
setting the proper bits in location 623 ($26F) for that mode. Only in 
the former method will you be able to get a readable screen, 
however. In the latter you will only create a four line, scrolling, 
unreadable window. You will be able to input and output as with 
any normal text window; you just won't be able to read it! GTIA, 
by the way, apparently Stands for "George's Television Interface 
Adapter." Whoever George is, thanks, but what is CTIA? 

See the OS User's Manual, the Hardware Manual, De Re Atari and 
COMPUTEI, July 1982 to September 1982, for more information. 

53248 D000 HPOSPO 

(W) Horizontal Position of player 0. Values from zero to 227 ($E3) 
are possible but, depending on the size of the playfield, the ränge 
can be from 48 ($30) as the leftmost Position to 208 ($D0) as the 
rightmost position. Other positions will be "off screen." 

Here are the normal screen boundaries for players and missiles. 
The values may vary somewhat due to the nature of your TV 
screen. Players and missiles may be located outside these 
boundaries, but will not be visible (off screen): 

Top 

32 For Single, 
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48 For both 
resolutions 


16 For Double Line 
resolution 


208 For both 
resolutions 


Bottom 

224 For Single, 
112 For Double Line 
resolution 



Although you can POKE to these horizontal position registers, they 
are reset to zero immediately. The player or missile will stay on the 
screen at the location specified by the POKE, but in order to move 
it using the horizontal position registers, you can't use: 

POKE 53248, PEEK (53248) + n (Or -n) 

which will end up generating an error message. Instead, you need 
to use something like this: 


10 

POKE 704,220: 

GRAPHICS 1: HPOS = 

53248: POKE 

623,8 

20 

N = 100: POKE 

HPOS,N: POKE 53261 

,255 


30 

If STICK(0) = 

11 Then N = N - 1: 

POKE HPOS,N: 

: Print N 

40 

50 

If STICK(0) = 
GoTo 30 

7 Then N = N + 1: 

POKE HPOS,N: 

Print N 


There are no vertical position registers for P/M graphics, so you 
must use Software routines to move players vertically. One idea for 
vertical motion is to reposition the player within the P/M region 
rather than the screen RAM. For example, the program below uses 
a small machine language routine to accomplish this move: 


1 REM LINES 5 To 70 Set UP THE PLAYER 

5 KEEP=PEEK(106)-16 

10 POKE 106,KEEP:POKE 54279,KEEP 

20 GRAPHICS 7+16:POKE 704,78:POKE 559 ,46:POKE 53277,3 
30 PMBASE=KEEP * 2 5 6 

40 For Loop=PMBASE+512 To PMBASE+640:POKE Loop,0:Next Loop:REM CLEAR OUT MEMORY FIRST 
50 X=100:Y=10:POKE 53248,X 

60 For Loop=0 To 7:Read Byte:POKE PMBASE+512+Y+Loop, Byte :Next Loop :REMPLAYER GRAPHICS 


INTO MEMORY 

70 DATA 129, 153,189,255,255,189, 153,129 

80 REM LINES 100 To 170 Set UP MACHINE LANGUAGE ROUTINE 
100 Dim UP$(21),DOWN$(21):UP=ADR(UP$) :DOWN=ADR(DOWN$) 

110 For Loop=UP To UP+20:Read Byte:PO KE Loop, Byte : Next Loop 

120 For Loop=DOWN To DOWN+20:Read BYT E:POKE Loop, Byte : Next Loop 

130 DATA 104,104,133,204,104,133,203, 160,1,177 

140 DATA 203,136,145,203,200,200,192, 11,208,245,96 

150 DATA 104,104,133,204,104,133,203, 160,10,177 

160 DATA 203,200,145,203,136,136,192, 255,208,245,96 

200 REM VERTICAL CONTROL 

210 If STICK(0)=14 Then GoSub 300 

220 If STICK(0)=13 Then D=USR(DOWN,PM BASE+511+Y):Y=Y+1 
250 GoTo 210 

300 U=USR(UP,PMBASE+511+Y):Y=Y-1 
310 Return 


This will move any nine-line (or less) size player vertically with the 
joystick. If you have a larger player size, increase the 11 in line 140 
to a number two larger than the number of vertical lines the player 
uses, and change the ten in line 150 to one greater than the 
number of lines. To add horizontal movement, add the following 


lines: 



6 

230 

240 

HPOS = 53248 

If STICK(0) = 11 Then X = X - 1: 
If STICK(0) = 7 Then X = X + 1: 

POKE HPOS, X 
POKE HPOS, X 
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You can use the routine to move any player by changing the 
number 511 in the USR calls to one less than the Start address of the 
object to be moved. See the appendix for a map of P/M graphics 
memory use. Missiles are more difficult to move vertically with this 
routine, since it moves an entire byte, not bits. It would be useful 
for moving all four missiles vertically if you need to do so; they 
could still be moved horizontally in an individual manner. 

See COMPUTE!, December 1981, February 1982, and May 1982, 
for some Solutions and some machine language move routines, and 
COMPUTE!, October 1981, for a solution with animation involving 
P/M graphics. 


MOPF 

(R) Missile 0 to playfield collision. This register will teil you which 
playfield the object has "collided" with, i.e., overlapped. If missile 
0 collides with playfield two, the register would read four and so 
on. Bit use is: 

Bit 7 6 5 4 3 

Playfield .unused. 3 

Decimal . 8 

53249 D00I HOPSP1 
(W) Horizontal position of player 1. 

Ml PF 

(R) Missile 1 to playfield collision. 

53250 D002 HPOSP2 

(W) Horizontal position of player 2. 

M2PF 

(R) Missile 2 to playfield collision. 

53251 D003 HPOSP3 

(W) Horizontal position of player 3. 

M3PF 

(R) Missile 3 to playfield collision. 

53252 D004 HPOSMO 

(W) Horizontal position of missile 0. Missiles move horizontally like 
players. See the note in 53248 ($D000) concerning the use of 
horizontal registers. 


2 10 

2 10 

4 2 1 


PöPF 

(R) Player 0 to playfield collisions. There are some problems using 
collision detection in graphics modes nine to eleven. There are no 
obviously recognized collisions in GR.9 and GR.11. In GR.10 
collisions work only for the playfield colors that correspond to the 
usual playfield registers. Also, the background (BAK) color is set 
by PCOLRO (location 704; $2C0) rather than the usual COLOR4 
(location 712; $2C8), which will affect the priority detection. In 
GR.10, playfield colors set by PCOLRO to PCOLR3 (704 to 707; 
$2C0 to $2C3) behave like players where priority is concerned. Bit 
use is: 


Bit 

Playfield 

Decimal 


7 6 5 4 

.unused. 


3 2 10 
3 2 10 
8 4 2 1 


53253 D005 HPOSM1 

(W) Horizontal position of missile 1. 
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PI PF 

(R) Player 1 to playfield collisions. 

53254 D006 HPOSM2 

(W) Horizonal Position of missile 2. 

P2PF 

(R) Player 2 to playfield collisions. 

53255 D007 HPOSM3 

(W) Horizontal Position of missile 3. 

P3PF 

(R) Player 3 to playfield collisions. 

53256 D008 SIZEPO 

(W) Size of player 0. POKE with zero or two for normal size (eight 
color clocks wide), POKE with one to double a player's width 
(sixteen color clocks wide), and POKE with three for quadruple 
width (32 color clocks wide). Each player can have its own width set. 
A normal size player might look something like this: 

00011000 

00111100 

01111110 

11111111 

11111111 

01111110 

00111100 

00011000 

In double width, the same player would like this: 

0000001111000000 

0000111111110000 

0011111111111100 

0011111111111100 

0000111111110000 

0000001111000000 

In quadruple width, the same player would become: 

00000000000011111111000000000000 

00000000111111111111111100000000 

00001111111111111111111111110000 

11111111111111111111111111111111 

11111111111111111111111111111111 

00001111111111111111111111110000 

00000000111111111111111100000000 

00000000000011111111000000000000 

Bit use is: 

Bit 7 6 5 4 3 2 1 

Size: .unused. 0 

0 
1 
1 

M0PL 

(R) Missile 0 to player collisions. There is no missile-to-missile 
collision register. Bit use is: 


Bit 76543210 

Player ..unused..3210 
Decimal . 8 4 2 1 


53257 D009 SIZEP1 

(W) Size of player 1. 


o 

0 Normal (8 color clocks) 

1 Double (16 color clocks) 

0 Normal 

1 Quadruple (32 color clocks) 
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Ml PL 

(R) Missile 1 to player collisions. 

53258 DOOA SIZEP2 
(W) Size of player 2. 

M2PL 

(R) Missile 2 to player collisions. 

53259 DOOB SIZEP3 
(W) Size of player 3. 

M3PL 

(R) Missile 3 to player collisions. 

53260 D00C SIZEM 

(W) Size for all missiles; set bits as below (decimal values 
included): 


Bits 





Size: 
Normal 

Double 

Quadruple 

7 

& 

6: 

missile 

3 

0, 128 

64 

192 

5 

& 

4 : 

missile 

2 

0, 32 

16 

48 

3 

& 

2 : 

missile 

1 

0, 8 

4 

12 

1 

& 

0: 

missile 

0 

0, 2 

1 

3 


where turning on the bits in each each pair above does as follows: 

0 And 0: normal size — two color clocks wide 
0 And 1: twice normal size — four color clocks wide 
1 And 0: normal size 

1 And 1: four times normal size — eight color clocks wide 

So, to get a double-sized missile 2, you would set BITs 5 and 6, or 
POKE 53260,48. Each missile can have a size set separately from 
the other missiles or players when using the GRAF registers. 

A number of sources, including De Re Atari, say that you can set 
neither missile sizes nor shapes separately. Here's a routine to 
show that you can in fact do both: 

10 POKE 53265,255: REM SHAPE START 
15 GR.7 

20 POKE 623,1: REM Set PRIORITIES 
30 For X = 1 To 25 
35 F = 50 

40 For C = 704 To 707: POKE C,F + X:F = F + 50: Next C: REM COLOURS 
45 S = 100 

50 For P = 53252 To 53255: POKE P,S+ X: S = S + 20: Next P : REM SCREEN POSITIONS 
60 Next X 

70 Input A,B: REM MISSILE SIZE And SHAPES 
80 POKE 53260,A: POKE 53265,5 
100 GoTo 30 


Here's another example using DMA; GRACTL and DACTL 
(53277 And 54272; $D01D And $D400): 

10 POKE 623,1: POKE 559,54: POKE 54279, 224: POKE 53277,1 
20 For N = 53252 To 53255: POKE N, 100 + X: X = X + 10: Next N: X = 0 
30 Input SIZE: POKE 53260, SIZE 
40 GoTo 30 

See 54279 ($D407) for more Information on P/M graphics. 

P0PL 

(R) Player 0 to player collisions. Bit use is: 


Bit 76543210 

Player ...unused.... 3 2 1 0 
Decimal . 8 4 2 1 
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53261 DOOD GRAFPO 

(W) Graphics shape for player 0 written directly to the player 
graphics register. In using these registers, you bypass ANTIC. 

You only use the GRAFP# registers when you are not using 
Direct Memory Access (DMA: see GRACTL at 53277). If DMA is 
enabled, then the graphics registers will be loaded automatically 
from the area specified by PMBASE (54279; $D407). 

The GRAF registers can only write a single byte to the playfield, 
but it runs the entire height of the screen. Try this to see: 

10 POKE 53248, 160: REM Set HORIZONTAL POSITION OF PLAYER 0 
20 POKE 704, 245: REM Set PLAYER 0 COLOUR To ORANGE 
30 POKE 53261, 203: REM BIT PATTERN11001011 

To remove it, POKE 53261 with zero. The bit Order runs from 
seven to zero, left to right across the TV screen. Each bit set will 
appear as a vertical line on the screen. A value of 255 means all 
bits are set, creating a wide vertical line. You can also use the 
size registers to change the player width. Using the GRAF 
registers will allow you to use players and missiles for such things 
as boundaries on game or text fields quite easily. 

PI PL 

(R) Player 1 to player collisions. 

53262 D00E GRAFP1 
(W) Graphics for player 1. 

P2PL 

(R) Player 2 to player collisions. 

53263 DOOF GRAFP2 

(W) Graphics for player 3. 

P3PL 

(R) Player 3 to player collisions. 

53264 D010 GRAFP3 

(W) Graphics for player 3. 

TRIG0 

(R) Joystick trigger 0 (644). Controller jack one, pin six. For all 
triggers, zero equals button pressed, one equals not pressed. If 
BIT 2 of GRACTL (53277; $D01 D) is set to one, then all TRIG 
BITs 0 are latched when the button is pressed (set to zero) and are 
only reset to one (not pressed) when BIT 2 of GRACTL is reset to 
zero. The effect of latching the triggers is to return a constant 
"button pressed" read until reset. 

53265 D011 GRAFM 

(W) Graphics for all missiles, not used with DMA. GRAFM works 
the same as GRAFPO above. Each pair of bits represents one 
missile, with the same allocation as in 53260 ($D00C) above. 

Bit 76 54 32 10 
Missile -3- -2- -1- -0- 

Each bit set will create a vertical line running the entire height of 
the TV screen. Missile graphics shapes may be set separately 
from each other by using the appropriate bit pairs. To mask out 
unwanted players, write zeros to the bits as above. 
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TRIG1 

(R) Joystick trigger 1 (645). Controller jack two, pin six. 

53266 D012 COLPMO 

(W) Color and luminance of player and missile 0 (704). Missiles 
share the same colors as their associated players except when 
joined together to make a fifth player. Then they take on the same 
value as in location 53733 ($D019; color register 3). 

TRIG2 

(R) Joystick trigger 2 (646). Controller jack three, pin six. 

53267 D013 COLPM1 

(W) Color and luminance of player and missile 1 (705). 

TRIG3 

(R) Joystick trigger 3 (647). Controller jack tour, pin six. 

53268 DOM COLPM2 

(W) Color and luminance of player and missile 2 (706). 

PAL 

(R) Used to determine if the Atari is PAL (European and Israeli 
TV compatible when BITs 1 - 3 equal zero) or NTSC (North 
American compatible when BITs 1 - 3 equal one; M decimal, $E). 
European Ataris run 12% slower if tied to the VBLANK cycle (the 
PAL VBLANK cycle is every 50th second rather than every 60th 
second). They use only one CPU clock at three MHZ, so the 6502 
runs at 2.217 MHZ - 25% faster than North American Ataris. 

Also, their $E000 and $F000 ROMs are different, so there are 
possible incompatibilities with North American Ataris in the 
cassette handling routines. There is a third TV Standard called 
SECAM, used in France, the USSR, and parts of Africa. I am 
unaware if there is any Atari support for SECAM Standards. 

PAL TV has more scan lines per frame, 312 compared to 262. 
NTSC Ataris compensate by adding extra lines at the beginning 
of the VBLANK routine. Display lists do not have to be altered, 
and colors are the same because of a hardware modification. 

53269 D015 COLPM3 

Color and luminance of player and missile 3 (707). 

53270 D016 COLPFO 

Color and luminance of playfield zero (708). 

53271 DOM COLPF1 

Color and luminance of playfield one (709). 

53272 D018 COLPF2 

Color and luminance of playfield two (710). 

53273 D019 COLPF3 

Color and luminance of playfield three (711). 

53274 D01A COLBK 

Color and luminance of the background (BAK).(712). 

53275 D01B PRIOR 

(W) Priority selection register. PRIOR establishes which objects 
on the screen (players, missiles, and playfields) will be in front of 
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other objects. Values used in this register are also described at 
location 623 ($26F), the shadow register. If you use conflicting 
priorities, objects whose priorities are in conflict will turn black 
in their overlap region. 

Priority Order 

(Decimal values In brackets): 


Bit 0=1 (1) 
Player 0 
Player 1 
Player 2 
Player 3 
Playfield 0 
Playfield 1 
Playfield 2 
Playfield 3 
Background 


And Player 5 


Bit 1=1 (2) 
Player 0 
Player 1 
Playfield 0 
Playfield 1 
Playfield 2 
Playfield 3 
Player 2 
Player 3 
Background 


And Player 5 


Bit 2 = 1 (4) : 

Playfield 0 
Playfield 1 
Playfield 2 

Playfield 3 And Player 5 

Player 0 

Player 1 

Player 2 

Player 3 

Background 


Bit 3=1 (8): 

Playfield 0 
Playfield 1 
Player 0 
Player 1 
Player 2 
Player 3 
Playfield 2 

Playfield 3 And Player 5 
Background 


Bit 4=1: Enable a fifth player out of the four missiles. 


Bit 5=1: Overlap of players 0 And 1, 2 And 3 is third color (Else 
overlap is black). The resulting color is a logical Or of the two 
player colors. 


Bits 6 And 7 are used To Select GTIA modes: 
0 0 = no GTIA modes 

0 1 = GTIA GR.9 

1 0 = GTIA GR.10 

1 1 = GTIA GR.11 


53276 D01C VDELAY 

(W) Vertical delay register. Used to give one-line resolution 
movement capability in the vertical positioning of an object when 
the two line resolution display is enabled. Setting a bit in 
VDELAY to one moves the corresponding object down by one TV 
line. If DMA is enabled, then moving an object by more than one 
line is accomplished by moving bits in the memory map instead. 


Bit 

7 

6 

5 

4 

3 

2 

1 

0 


Decimal 

128 

64 

32 

16 

8 

4 

2 

1 


Object 
Player 3 
Player 2 
Player 1 
Player 0 
Missile 3 
Missile 2 
Missile 1 
Missile 0 


53277 D01D GRACTL 

(W) Used with DMACTL (location 54272; $D400) to latch all stick 
and paddle triggers (to remember if triggers on joysticks or 
paddles have been pressed), to turn on players and to turn on 
missiles. To get the values to be POKEd here, add the following 
options together for the desired function: 


Decimal Bit 

To turn On missiles 1 0 
To turn On players 2 1 
To latch trigger inputs 4 2 


To revoke P/M authorization and turn off both players and 
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missiles, POKE 53277,0. Once latched, triggers will give a 
continuous "button pressed" read the first time they are pressed 
until BIT 2 is restored to zero. Triggers are placed in "latched" 
mode when each individual trigger is pressed, but you cannot set 
the latch mode for individual triggers. 

Have you ever hit BREAK during a program and still had players 
or their residue left on the screen? Sometimes hitting RESET 
doesn't clear this material from the screen. There are ways to get 
rid of it: 

POKE 623,4: This moves all players behind playfields. 

POKE 53277,0: This should turn them off. 

POKE 559,2: This should Return you To a blank screen. 

Make sure you SAVE your program betöre POKEing, just in 
case! 

53278 D01E HITCLR 

(W) POKE with any number to clear all player/missile collision 
registers. It is important to clear this register often in a program 
-- such as a game - which frequently tests for collisions. 
Otherwise, old collision values may remain and confuse the 
program. A good way to do this is to POKE HITCLR just betöre 
an event which may lead to a collision; for example, right betöre 
a joystick or paddle is "read" to move a player or fire a missile. 
Then test for a collision immediately after the action has taken 
place. Remember that multiple collisions cause sums of the 
collision values to be written to the collision registers; if you do 
not clear HITCLR often enough, a program checking for 
individual collisions will be thrown off by these sums. 

53279 D01F CONSOL 

(W/R) Used to see if one of the three yellow console buttons has 
been pressed (not the RESET button!). To clear the register, 
POKE CONSOL with eight. POKEing any number from zero to 
eight will cause a dick from the Speaker. A FOR-NEXT loop that 
alternately POKEs CONSOL with eight and zero or just zero, 
since the OS put in an 8 every 1/60 second, will produce a buzz. 
Values PEEKed will ränge from zero to seven according to the 
following table: 


1 Key 


Value 

0 

1 

2 

3 

4 

5 

6 

7 

1 Option 



X 

X 

X 

X 





1 Select 



X 

X 



X 

X 



|START 



X 


X 


X 


X 


— 

Bits 

2 


0 

0 

0 

0 

1 

1 

1 

1 


1 


0 

0 

1 

1 

0 

0 

1 

1 


0 


0 

1 

0 

1 

0 

1 

0 

1 


Where zero means all keys have been pressed, one means 
OPTION and SELECT have been pressed, etc., to seven, which 
means no keys have been pressed. CONSOL is updated every 
stage two VBLANK procedure with the value eight. 

It is possible to use the console Speaker to generate different 
sounds. Here is one idea based on an article in COMPUTER 
August 1981: 

10 GoSub 1000 
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20 TEST = USR(1536) 

999 End 

1000 For Loop = 0 To 26: Read Byte: POKE 1536 + Loop, Byte: Next Loop: Return 
1010 DATA 104,162,255,169,255,141,31,208,169 

1020 DATA 0,160,240,136,208,253,141,31,208,160 
1030 DATA 240,136,208,253,202,208,233,96 

To change the tone, you POKE 1547 and 1555 with a higher or 
lower value (both are set to 240 above). To change the tone 
duration, you POKE 1538 with a lower value (it is set to 255 in the 
routine above). Do these betöre you do your USR call or alter the 
DATA Statements to permanently change the values in your own 
program. Turn off DMA (see location 559) to get clearer tones. 


4.8.6.2 53280 - 53503 

Locations 53280 to 53503 ($D020 to $D0FF) are repeats of locations 53248 to 53279 ($D000 to 
$D01 F). You can't use any of the repeated locations; consider them "filier." They maybe used for 
other purposes in any Atari OS Upgrade. 


4.8.6.3 53504 - 53759 

Locations 53504 to 53759 ($D100 to $D1 FF) are unused. These locations are not empty; you can 
PEEK into them and find out what's there. They cannot, however, be user-altered. 

4.8.6.4 53760 - 53775 (POKEY) 

POKEY 

DECIMAL HEX LABEL 
53760-54015 D200-D2FF 

POKEY is a digital I/O Chip that Controls the audio frequency and 
control registers, frequency dividers, poly noise counters, pot 
(paddle) Controllers, the random number generator, keyboard 
scan, serial port I/O, and the IRQ interrupts. 

The AUDF# (audio frequency) locations are used for the pitch for 
the corresponding sound Channels, while the AUDC# (audio 
control registers) are the volume and distortion values for those 
same channels. To POKE sound values, you must first POKE zero 
into locations 53768 ($D208) and a three into 53775 ($D20F). 

Frequency values can ränge from zero to 255 ($FF), although the 
value is increased by the Computer by one to ränge from one to 
256. Note that the sum of the volumes should not exceed 32, since 
volume is controlled by the least four bits. It is set from zero as no 
volume to 15 ($F) as the highest. A POKE with 16 ($10) forces 
sound output even if volume is not set (i.e., it pushes the Speaker 
cone out. A tiny "pop" will be heard). The upper four bits control 
distortion: 192 ($C0) is for pure tone; other values ränge from 32 to 
192. Note that in BASIC, the BREAK key will not turn off the 
sound; RESET will, however. See De Re Atari and BYTE, April 
1982, for more information on sound generation. 

The AUDF registers are also used as the POKEY hardware timers. 

These are generally used when counting an interval less than one 
VBLANK. For longer intervals, use the Software timers in locations 
536 to 545 ($218 to $221). You load the AUDCTL register with the 
number for the desired clock frequency. You then set the volume 
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to zero in the AUDC register associated with the AUDF register 
you plan to use as a timer. You load the AUDF register itself with 
the number of clock intervals you wish to count. Then you load 
your interrupt routine into memory, and POKE the address into the 
appropriate timer vector between locations 528 and 533 ($210 and 
$215). You must set the proper bit(s) in IRQEN and its shadow 
register POKMSK at location 16 ($10) to enable the interrupt. 
Finally, you load STIMER with any value to load and Start the 
timer(s). The OS will force a jump to the timer vector and then to 
your routine when the AUDF register counts down to zero. Timer 
Processing can be preempted by ANTIC's DMA, a DU, or the 
VBLANK process. 

POT values are for the paddles, ranging from zero to 240, 
increasing as the paddle knob is turned counterclockwise, but 
values less than 40 and greater than 200 represent an area on 
either edge of the screen that may not be visible on all TV sets or 
monitors. 


53760 D200 AUDF1 

(W) Audio channel one frequency. This is actually a number (N) 
used in a "divide by N Circuit"; for every N pulses coming in (as set 
by the POKEY clock), one pulse goes out. As N gets larger, output 
pulses will decrease, and thus the sound produced will be a lower 
note. N can be in the ränge from one to 256; POKEY adds one to 
the value in the AUDF register. See BYTE, April 1982, for a 
program to create chords instead of single tones. 

POTO 

(R) Pot (paddle) 0 (624); pot is short for Potentiometer. Turning the 
paddle knob clockwise results in decreasing pot values. For 
machine language use: these pot values are valid only 228 scan 
lines after the POTGO command or after ALLPOT changes (see 
53768; $D208 and 53771; $D20B). POT registers continually count 
down to zero, decrementing every scan line. They are reset to 228 
when they reach zero or by the values read from the shadow 
registers. This makes them useful as System timers. See 
COMPUTEI, February 1982, for an example of this use. 

The POTGO sequence (see 53771; $D20B) resets the POT 
registers to zero, then reads them 228 scan lines later. For the fast 
pot scan, BIT 2 of SKCTL at 53775 ($D20F) must be set. 


53761 D201 AUDC1 

(W) Audio channel one control. Each AUDF register has an 
associated control register which sets volume and distortion levels. 
The bit assignment is: 


Bit 765 
Distortion 
(noise) 

0 0 0 

0 0 1 

etc. To: 
111 


4 

3 

2 

1 

0 


Volume 


Volume 



only 


level 



0 

0 

0 

0 

0 

Lowest 


0 

0 

0 

1 



etc. 

To: 



1 

1 

1 

1 

1 

Highest 

(forced 






Output) 







The values for the distortion bits are as follows. The first process is 
to divide the clock value by the frequency, then mask the output 
using the polys in the order below. Finally, the result is divided by 
two. 

Bit 
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7 

6 

5 




0 

0 

0 

f ive 

bit, Then 17 bit, polys 


0 

0 

1 

f ive 

bit poly only 


0 

1 

0 

f ive 

bit, Then four bit, polys 


0 

1 

1 

f ive 

bit poly only 


1 

0 

0 

17 bit poly only 


1 

0 

1 

no poly counters (pure tone) 


1 

1 

0 

four 

bit poly only 


1 

1 

1 

no poly counters (pure tone) 


In general, the tones become more regulär (a recognizable 


droning becomes apparent) with fewer and lower value polys 
masking the output. This is all the more obvious at low frequency 
ranges. POKE with 160 ($A0) or 224 ($E0) plus the volume for pure 
tones. 

See De Re Atari and the Hardware Manual for details. 

POTI 

(R) Pot 1 register (625). 

53762 D202 AUDF2 

(W) Audio channel two frequency. Also used with AUDF3 to störe 
the 19200 baud rate for SIO. 

POT2 

(R) Pot 2 (626). 

53763 D203 AUDC2 

(W) Audio channel two control. 

POT3 

(R) Pot 3 (627). 

53764 D204 AUDF3 

(W) Audio channel three frequency. Used with AUDF3 above and 
with AUDF4 to störe the 600 baud rate for SIO. 

POT4 

(R) Pot 4 (628). 

53765 D205 AUDC3 

(W) Audio channel three control. 

POT5 

(R) Pot 5 (629). 

53766 D206 AUDF4 

(W) Audio channel four frequency. 

POT6 

(R) Pot 6 (630). 

53767 D207 AUDC4 

(W) Audio channel four control. 

POT7 

(R) Pot 7 (631). 

53768 D208 AUDCTL 

(W) Audio control. To properly initialize the POKEY sound 
capabilities, POKE AUDCTL with zero and POKE 53775,3 
($D20F). These two are the equivalent of the BASIC Statement 
SOUND 0,0,0,0. AUDCTL is the Option byte which affects all 
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sound channels. This bit assignment is: 

Bit Description: 

7 Makes the 17 bit poly counter into nine bit poly 
(see below) 

6 Clock channel one with 1.79 MHz 
5 Clock channel three with 1.79 MHz 
4 Join channels two and one (16 bit) 

3 Join channels tour and three (16 bit) 

2 Insert high pass filter into channel one, clocked by channel 
two 

1 Insert high pass filter into channel two, clocked by channel 
four 

0 Switch main clock base from 64 KHz to 15 KHz 

Poly (polynomial) counters are used as a source of random pulses 
for noise generation. There are three polys: four, five and 17 bits 
long. The shorter polys create repeatable sound patterns, while the 
longer poly has no apparent repetition. Therefore, setting BIT 7 
above, making the 17-bit into a nine-bit poly will make the pattern 
in the distortion more evident. You chose which poly(s) to use by 
setting the high three bits in the AUDC registers. The 17-bit poly is 
also used in the generation of random numbers; see 53770 
($D20A). 

The clock bits allow the user to speed up or slow down the clock 
timers, respectively, making higher or lower frequency ranges 
possible. Setting the channels to the 1.79 MHz will produce a 
much higher sound, the 64 KHz clock will be lower, and the 15 
KHz clock the lowest. The clock is also used when setting the 
frequency for the AUDF timers. 

Two bits (three and four) allow the user to combine channels one 
and two or three and four for what amounts to a nine octave ränge 
instead of the usual five. Here's an example from De Re Atari of 
this increased ränge, which uses two paddles to change the 
frequency: the right paddle makes coarse adjustments, the left 
paddle makes fine adjustments: 

10 SOUND 0,0,0,0:POKE 53768,80:REM Set CLOCK And JOIN CHANNELS 1 And 2 
20 POKE 53761, 160:POKE 53763, 168:REMTURN OFF CHANNEL 1 And Set 2 To PURE TONE 
GENERATION 

50 POKE 53760,PADDLE(0):POKE 53762,PADDLE(1): GoTo 30 

High pass filters allow only frequencies higher than the clock value 
to pass through. These are mostly used for special effects. Try: 

10 SOUND 0,0,0,0:POKE 53768,4:REM HIGH PASS FILTER On CHANNEL 1 
20 POKE 53761,168:POKE 53765,168:REMPURE TONES 
30 POKE 53760,254:POKE 53764,127 
40 GoTo 40 

See the excellent chapter on sound in De Re Atari: it is the best 
explanation of sound functions in the Atari available. See also the 
Hardware Manual for complete details. 

ALLPOT 

(R) Eight line pot port state; reads all of the eight POTs together. 

Each bit represents a pot (paddle) of the same number. If a bit is 
set to zero, then the register value for that pot is valid (it's in use); if 
it is one, then the value is not valid. ALLPOT is used with the 
POTGO command at 53771 ($D20B). 
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53769 D209 STIMER 

(W) Start the POKEY timers (the AUDF registers above). You 
POKE any non-zero value here to load and Start the timers; the 
value isn't itself used in the calculations. This resets all of the audio 
frequency dividers to their AUDF values. If enabled by IRQEN 
below, these AUDF registers generate timer interrupts when they 
count down from the number you POKEd there to zero. The 
vectors for the AUDF1, AUDF2 and AUDF4 timer interrupts are 
located between 528 and 533 ($210 and $215). POKEY timer tour 
interrupt is only enabled in the new "B" OS ROMs. 

KBCODE 

(R) Holds the keyboard code which is then loaded into the shadow 
register (764; $2FC) when a key is hit. Usually read in response to 
the keyboard interrupt. Compares the value with that in CHI at 
754 ($2F2). If both values are the same, then the new code is 
accepted only if a suitable key debounce delay time has passed. 

The routines which test to see if the key code will be accepted Start 
at 65470 ($FFBE). BIT 7 is the control key flag, BIT 6 is the shift key 
flag. 

53770 D20A SKREST 

(W) Reset BITs 5 - 7 of the serial port Status register at 53775 to one. 
RANDOM 

(R) When this location is read, it acts as a random number 
generator. It reads the high order eight bits of the 17 bit 
polynomial counter (nine bit if BIT 7 of AUDCTL is set) for the 
value of the number. You can use this location in a program to 
generate a random integer between zero and 255 by: 

10 Print PEEK(53770) 

This is a more elegant solution than INT(RND(0) * 256). For a test of 
the values in this register, use this simple program: 

10 FOR N = 1 TO 20: PRINT PEEK(53770): NEXT N 

53771 D20B POTGO 

(W) Start the POT scan sequence. You must read your POT values 
first and then Start the scan sequence, since POTGO resets the 
POT registers to zero. Written by the stage two VBLANK 
sequence. 

53772 D20C 
Unused. 

53773 D20D SEROUT 

(W) Serial port data output. Usually written to in the event of a 
serial data out interrupt. Writes to the eight bit (one byte) parallel 
holding register that is transferred to the serial shift register when a 
full byte of data has been transmitted. This "holding" register is 
used to contain the bits to be transmitted one at a time (serially) as 
a one-byte unit betöre transmission. 

SERIN 

(R) Serial port input. Reads the one-byte parallel holding register 
that is loaded when a full byte of serial input data has been 
received. As above, this holding register is used to hold the bits as 
they are received one bit at a time until a full byte is received. This 
byte is then taken by the Computer for processing. Also used to 
verify the checksum value at location 49 ($31). 
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The serial bus is the port on the Atari into which you plug your 
cassette or disk cable. For the pin values of this port, see the OS 
User's Manual, p. 133, and the Hardware Manual. 

53774 D20E IRQEN 

(W) Interrupt request enable. Zero turns off all Interrupt requests 
such as the BREAK key; to disable or re-enable Interrupts, POKE 
with the values according to the following chart (setting a bit to one 
-- i.e., true -- enables that Interrupt; decimal values are also 
shown for each bit): 


Bit 

Decimal 

Interrupt 

Vector 

0 

1 

Timer 1 (counted down To zero) 

VTIMR1 
(528; $210) 

1 

2 

Timer 2 (counted down To zero) 

VTIMR2 
(530; $212) 

2 

4 

Timer 4 (counted down To zero) 

VTIMR4 

(532; $214), 0 
"B" ROMS only) 

3 

8 

Serial Output transmission done 

VSEROC (526; 
$20E) 

4 

16 

Serial Output data needed 

VSEROR 
(524; $20C) 

5 

32 

Serial Input data ready 

VSERIN 
(522; $2 OA) 

6 

64 

Other key pressed 

VKEYBD 
(520; $208) 

7 

128 

BREAK key pressed 

see below 


Here is the procedure for the BREAK key Interrupt: clear the 
Interrupt register. Set BRKKEY (17; $11) to zero; clear the 
start/stop flag SSFLAG at 767 ($2FF); clear the Cursor inhibit flag 
CRSINH at 752 ($2F0); clear the attract mode flag at 77 ($4D), and 
return from the Interrupt after restoring the 6502 A register. (There 
is now (in the OS "B" ROMs) a proper vector for BREAK key 
Interrupts at 566, 567 ($236, $237) which is initialized to point to 
59220 ($E754).) If the Interrupt was due to a serial I/O bus proceed 
line Interrupt, then vector through VPRCED at 514 ($202). If due to 
a serial I/O bus Interrupt line Interrupt, then vector through 
VINTER at 516 ($204). If due to a 6502 BRK instruction, then vector 
through VBREAK at 518 ($206). 

Timers relate to audio dividers of the same number (an Interrupt is 
processed when the dividers count down to zero). These bits in 
IRQEN are not set on powerup and must be initiated by the user 
program betöre enabling the processor IRQ. 

There are two other interrupts, processed by PIA, generated over 
the serial bus Proceed and Interrupt lines, set by the bits in the 
PACTL and PBCTL registers (54018 and 54019; $D302, $D303): 


Bit 

Decimal 

Locution 

Interrupt 



0 

1 

PACTL 

Peripheral 

bit. 

A 

(PORTA) interrupt enable 

7 

128 

PACTL 

Peripheral 

A 

interrupt Status bit. 

0 

1 

PBCTL 

Peripheral 

bit. 

B 

(PORTB) interrupt enable 

7 

128 

PBCTL 

Peripheral 

B 

interrupt Status bit. 


The latter PORT interrupts are automatically disabled on powerup. 
Only the BREAK key and data key interrupts are enabled on 
powerup. The shadow register is 16 ($10). 

IRQST 

(R) Interrupt request Status. Bit functions are the same as IRQEN 
except that they register the interrupt request when it is zero rather 
than the enable when a bit equals one. IRQST is used to determine 
the cause of interrupt request with IRQEN, PACTL and PBCTL as 
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above. 

All IRQ Interrupts are normally vectored through 65534 ($FFFE) to 
the IRQ Service routine at 59123 ($E6F3), which determines the 
cause of the Interrupt. The IRQ global RAM vector VIMIRQ at 534 
($216) ordinarily points to the IRQ processor at 59126 ($E6F6). The 
processor then examines 53774 ($D20E) and the PIA registers at 
54018 and 54019 to determine the Interrupt cause. Once 
determined, the routine vectors through one of the IRQ RAM 
vectors in locations 514 to 526 ($202 to $20E). For Non-Maskable 
Interrupts (NMI's), see locations 54286 to 54287 ($D40E; $D40F). 

See the OS User’s Manual for complete details. 

53775 D20F SKCTL 

(W) Serial port control. Holds the value 255 ($255) if no key is 
pressed, 251 ($FB) for most other keys pressed, 247 ($F7) for 
SFIIFT key pressed (*M). See the (R) mode below for an 
explanation of the bit functions. POKE with three to stop the 
occasional noise from cassette after I/O to bring POKEY out of the 
two-tone mode. (562). 

SKSTAT 

(R) Beads the serial port Status. It also returns values governed by 
a Signal on the digital track of the cassette tape. You can generate 
certain values using the SOUND command in BASIC and a PEEK 
to SKSTAT: 

SOUND 0,5,10,15 returns a value to here of 255 (or, on occasion, 127). 
SOUND 0,8,10,3 returns a value of 239. 

This is handy for adding a voice track to Atari tapes. You use the 
left channel for your voice track and the right for the tone(s) you 
want to use as cuing marks. You can use the Speaker on your TV to 
generate the tones by placing the right microphone directly in 
front of the Speaker. The Computer will register these tones in this 
register when it encounters them during a later cassette load. See 
COMPUTER July 1981, for some other suggestions on doing this. 
Bemember, you can turn the cassette off by POKEing 54018 
($D302) with 60 ($3C) and back on with 52 ($34). 

Bits in the SKCTL (W) register are normally zero and perform the 
functions below when set to one. The Status when used as (R) is 
listed below the write (W) function: 

Bit Function 

0 (W) Enable keyboard debounce circuits. 

(R) Not used by SKSTAT. 

1 (W) Enable keyboard scanning Circuit. 

(R) Serial input shift register busy. 

2 (W) Fast pot scan: the pot scan counter completes its 
sequence in two TV line times instead of one frame time (228 
scan lines). Not as accurate as the normal pot scan, 
however. 

(R) the last key is still pressed. 

3 (W) Serial output is transmitted as a two-tone Signal rather 
than a logic true/false. POKEY two-tone mode. 

(R) The shift key is pressed. 

4,5,6 (W) Serial port mode control used to set the bi-directional 
clock lines so that you can either receive external clock data 
or provide clock data to external devices (see the Hardware 
Manual, p. 11.27). There are two pins on the serial port for 
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Clock IN and Clock OUT data. See the OS User's Manual, 
p. 133. 

4 (R) Data can be read directly from the serial input port, 
ignoring the shift register. 

5 (R) Keyboard over-run. Reset BITs 7 to 5 (latches) to one 
using SKRES at 53770 ($D20A). 

6 (R) Serial data input over-run. Reset latches as above. 

7 (W) Force break (serial output to zero). 

(R) Serial data input frame error caused by missing or extra 
bits. Beset latches as above. 

BIT 2 is first set to zero to reset POT registers to zero (dumping the 
capacitors used to change the POT registers). Then BIT 2 is set to 
one to enable the fast scan. Fast scan is not as accurate as the 
normal scan routine. BIT 2 must be reset to zero to enable the 
normal scan mode; otherwise, the capacitors will never dump. 

4.8.6.5 53776-54015 

Locations 53776 to 54015 ($D210 to $D2FF) are duplications of locations 53760 to 53775 and 
have no particular use at present. 


4.8.6.6 54016-54019 (PIA: 6520) 

PIA: 6520 CHIP 

DECIMAL HEX LABEL 
54016-54271 D300-D3FF 

The Peripheral Interface Adapter (PIA) integrated Circuit is a 
special microprocessor used to control the Atari ports, Controller 
jacks one to four. Ports can be used for both input and output 
simultaneously or alternately. Barely tapped at the time of this 
writing, the ports represent a major resource for external (and 
internal) control and expansion. PIA also processes two of the IRQ 
Interrupts: VINTER and VPRCED, vectored at locations 514 to 517 
($202 to $205). These Interrupts are unused by the OS, but also 
may be used to provide greater control over external devices. 

54016 D300 PORTA 

(W/R) Reads or writes data from Controller jacks one and two if BIT 
2 of PACTL (location 54018) is one. Writes to direction control if 
BIT 2 of PACTL is zero. 

These two port registers also control the direction of data flow to 
the port, if the Controller register (54018, below) is POKEd with 48 
($30). Then, if the bits in the register read zero, it is in input (R) 
mode; if they read one, it is in output (W) mode. A zero POKEd 
here makes all bits input, a 255 ($FF) makes all bits output. BITs 0 
to 3 address pins one to four on jack one, BITs 4 to 7 address pins 
one to four on jack two. POKE 54018 with 52 to make this location 
into a data register again. Shadow registers are: STICK0 (632; 
$278, jack one), STICK1 (633; $279, jack two) and PTRIGO-3 
(636-639; $27C-$27F). 

Bits used As data register 
76543210 
—Jack 0— —Jack 1 — 

—Stick 1— —Stick 0— 

Forward = BIT 0, 4 = 1 
Backward = BIT 1, 5 = 1 
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Left = BIT 2,6 = 1 

Right = BIT 3,7 = 1 

Neutral = All four jack bits = 1 


PORTA is also used to test if the paddle 0-3 triggers (PTRIG) have 
been pressed, using these bits: 

Bit 76543210 

PTRIG 32 — — 10 — — 

Where zero in the appropriate bit equals trigger pressed, one 
equals trigger not pressed. 

The PORT registers are also used in the keyboard Controller (used 
with a keypad) Operation where: 


Bit 76543210 

Row 4 3 2 Top 4 3 2 Top 

Jack .2. .1. 


Columns for the keyboard Operation are read through the POT 
(PADDL) and TRIG registers. See Micro, May 1982, and the 
Hardware Manual for more information on jacks and ports. 

54017 D301 PORTB 

(W/R) Port B. Reads or writes data to and/or from jacks three and 
four. Same as PORTA, above, for the respective jacks. Shadow 
registers are: STICK2 (634; $27A, jack three), STICK3 (635, $27B, 
jack four), and PTRIG4-7 (640-643; $280-$283). 

54018 D302 PACTL 

(W/R) Port A Controller (see 54016 above). POKE with 60 ($3C) to 
turn the cassette motor off, POKE with 52 to turn it on. You can put 
a music cassette in your program recorder, press PLAY and then 
POKE 54018,52. Your music will play through the TV Speaker or 
external amplifier while you work at the Atari. You can use this 
technique to add voice tracks to your programs. To turn off the 
music or voice, type POKE 54018,60. 


PACTL can be used for other external applications by the user. Bit 
use is as follows: 


Bit 

7 (Read only) 


6 

5 

4 

3 (Write) 
2 (Write) 
1 

0 (Write) 


Function 

Peripheral A interrupt (IRQ) Status bit. Set by 
Peripheral (PORT) A. Reset by reading PORTA 
(53774; $D20E). 

Set To zero. 

Set To one. 

Set To one. 

Peripheral motor control Line (turn the cassette On 
Or off; zero eguals On). 

Controls PORTA addressing. One eguals PORTA 
register; zero equals direction control register. 
Set To zero. 

Peripheral A interrupt (IRQ) enable. One equals 
enable. Set by the OS but available To the user; 
reset On powerup. 


54019 D303 PBCTL 

(W/R) Port B Controller. Initialized to 60 ($3C) by the OS IRQ 
code. PBCTL is the same as PACTL, above, with the following 
exception (this may actually perform the same function as in 
PACTL, but I am not sure of the distinction between descriptions): 


Bit Function 

3 Peripheral command Identification (serial bus 

command), initialized To 60 ($3C). 


Ports can be used for external control applications by the 
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technically minded reader who is willing to do some soldering to 
develop cables and connectors. A good example can be found in 
COMPUTE!, February 1981, where the author gives directions for 
using jacks three and four as a printer port. The Macrotronic 
Printer cables use just this method, bypassing the 830 interface 
entirely (one way of reducing your hardware costs). Theoretically, 
the entire Atari can be controlled through the ports! 


4.8.6.7 54020 - 54271 

Locations 54020 to 54271 ($D304 to $D3FF) are repeats of locations 54016 to 54019 ($D300 to 
$D303). 

4.8.6.8 54272 - 54287 (ANTIC) 

ANTIC 

DECIMAL HEX LABEL 
54272-54783 D400-D5FF 

ANTIC is a special, separate microprocessor used in your Atari 
to control C/GTIA, the screen display, and other screen-related 
functions including processing the NMI interrupts. It uses its own 
instruction set, called the display list, which teils ANTIC where to 
find the screen data in RAM and how to display it. ANTIC also 
uses an internal four bit counter called the Delta Counter (DCTR) 
to control the vertical dimension of each block. 

54272 D400 DMACTL 

(W) Direct Memory Access (DMA) control. It is also used to 
define one- or two-line resolution for players and to turn on 
players and missiles. Values are POKEd into the shadow register, 

559 ($22F), and are also described there. You POKE the shadow 
register with the following numbers in order to: 


Turn off the playfield 0 
Use narrow playfield 1 
Use normal playfield 2 
Use wide playfield 3 
Enable missile DMA 4 
Enable player DMA 8 


Enable both player And missile DMA 12 

Single Line player resolution 16 

Enable DMA Fetch instructions 32 

Double line resolution is the default Status. Use this register in 
conjunction with GRACTL at 53277 ($D01 D). Both must be set 
properly or no display will result. BIT 5 enables DMA to fetch the 
display list instructions. If BIT 5 is not set (BIT 5 equals zero), 
ANTIC will not work. DMACTL is initialized to 34 ($22). 

A player in single line resolution might look like this: 


00011000 

## 

00111100 

#### 

01111110 

###### 

11111111 

######## 

11111111 

######## 

01111110 

###### 

00111100 

#### 

00011000 

## 


so that each byte is displayed on one TV line. The same player in 
double line resolution would look like this: 

00011000 ## 
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00011000 

00111100 

00111100 

01111110 

01111110 

11111111 

11111111 

11111111 

11111111 

01111110 

01111110 

00111100 

00111100 

00011000 

00011000 



###### 

###### 


######## 

######## 

######## 

######## 

###### 

###### 

#### 

#### 

## 

## 


where every byte is displayed over two TV lines. 


54273 D401 CHACTL 

(W) Character mode control. See shadow register 755 for values 
that can be POKEd in. Only the least three bits (decimal zero to 
seven) are read, as below: 


Decimal 0 

Cursor 

Transparent X 

Opaque 

Present 

Absent X 


1 


X 

X 


2 3 4 5 


6 7 


X 

X 

X X 


X 

X 


X 

X 


X 

X 


X 

X 


Characters 

Normal X X X X 

Inverted X X X X 

54274,5 D402,3 DLISTL/H 

Display list pointer. Teils the OS the address of the display list 
instructions about what screen mode(s) to display and where to 
find the screen data. See SDLIST (560, 561; $230, $231). 

54276 D404 HSCROL 

(W) Horizontal scroll enable, POKE HSCROL with from zero to 
16 clock cycles for the number of cycles to scroll. Horizontal fine 
scrolls can be used only if BIT 4 of the display list instruction is 
set. The difficulty in horizontal Scrolling lies in arranging the 
screen data to be scrolled in such a manner as to prevent 
wraparound (i.e., the bit or byte scrolled off screen in one line 
becomes the bit or byte scrolled on screen in an adjacent line). 
Normal data arranged for TV display looks like this on the screen: 



where it is a one-dimensional memory area "folded" at the proper 
places to create the image of a two dimensional screen. This is 
done by the DL character or map mode instruction. Without 
other instructions, it reads the memory continuously from the first 
specified location, each line taking the correct number of bytes 
for the GRAPHICS mode specified. To properly scroll it 
horizontally, you must arrange it in relation to the TV screen like 
this: 
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+ 


+ 


Now you will have to make each display instruction for each line 
into a Load Memory Scan (LMS) instruction. To direct each LMS 
to the proper screen RAM for that line, you will have to increment 
each memory location by the total length of the line. For 
example, if you want to scroll a 256-byte horizontal screen, each 
LMS instruction will have to point to a location in memory 256 
bytes above the last one. Of course, you will have to implement 
error-trapping routines so that your screen does not extend 
beyond your desired boundaries. 

Coarse scrolling, one byte at a time, can be done without setting 
the HSCROL register by the method described above. For 
smooth scrolling, you will have to use this register. See De Re 
Atari. 

54277 D405 VSCROL 

(W) Vertical scroll enable, POKE VSCROL with from zero to 16 
scan lines, depending on the GRAPHICS mode of the screen for 
the number of scan lines to scroll. Vertical fine scrolls can be 
used only if BIT 5 of the display list instruction has been set. 

Coarse scrolling can be done without using this register, simply 
by moving the top of the screen address (as defined by the DL 
LMS instruction) up or down one mode line (plus or minus 40 or 
20 bytes, depending on the GRAPHICS mode). The top of the 
screen address can be found by: 

10 DLIST = PEEK(560) + PEEK(561) * 256 

20 SCRNLO = DLIST + 4: SCRNHI = DLIST + 5: REM LSB/MSB OF SCREEN ADDRESS 

25 Print "SCREEN ADDRESS = " PEEK(SCRNLO) + PEEK(SCRNHI) * 256 


You could Then add a routine To this For a coarse - scroll vertically 
through the memory With a joystick, such As: 

30 LOBYTE = 0: HIBYTE = 0 

40 If STICK(0) = 14 Then LOBYTE = LOBYTE + 40:GoTo 100 

50 If STICK(0) = 13 Then LOBYTE = LOBYTE - 40 

60 If LOBYTE < 0 Then LOBYTE = LOBYTE + 256: HIBYTE = HIBYTE - 1 

70 If HIBYTE < 0 Then HIBYTE = 0 

80 GoTo 200 

100 If LOBYTE 255 Then LOBYTE = LOB YTE - 256 
110 HIBYTE = HIBYTE + 1 

200 POKE SCRNLOW, LOBYTE: POKE SCRNHI , HIBYTE 
210 GoTo 40 

Coarse scrolling is relatively easy to implement in the Atari: one 
basically alters the screen RAM to display the new material. Fine 
scrolling is more difficult: each scroll register must be POKEd 
with the number of units to be scrolled - color clocks or scan 
lines -- and the corresponding display list instructions must have 
the proper bits set. This means you can selectively fine scroll any 
mode lines you wish by setting only those bits of the lines you 
intend to scroll. Other lines will be displayed normally. You can 
set a DL instruction for both horizontal and vertical scroll enable. 

See the Hardware Manual for a discussion of the problems in fine 
scrolling. 

Fine scrolling will allow only a certain amount of data to be 
scrolled betöre the register must be reset (16 clock bits or scan 
lines maximum). In order to make the scrolling activity 
continuous, the register involved must be reset to zero when the 
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desired value is reached, a coarse scroll must be implemented 
(usually during a DLI or VBLANK interval) and a new fine scroll 
begun. This is not easily done in BASIC since it is too slow, and 
changing registers during ANTIC's display process usually 
causes rough or jerky motion. Assembly routines are suggested 
for smooth display. See De Re Atari, Micro, November 1981, 

BYTE, January 1982, and Santa Cruz's Tricky Tutorial #2 for 
more information. 

54278 D406 
Unused. 

54279 D407 PMBASE 

(W) MSB of the player/missile base address used to locate the 
graphics for your players and missiles (the address equals 
PMBASE * 256. P/M graphics are tricky to use since there are no 
direct Atari 8K BASIC commands to either create or move them 
(there are, however, commands for P/M graphics in BASIC A+ 
and in valFORTH Utilities). 

Your P/M graphics must always begin on a 1K boundary 
(PEEK(RAMTOP)-4 for double line resolution players) or 2K 
boundary (PEEK(RAMTOP)-5 for single line resolution), so the 
LSB is always zero (page numbers always end in $XX00). For 
example: 

10 POKE 106, PEEK(106) - 8: GRAPHICS 8: SETCOLOR 2,3,4 
20 POKE 559,62: POKE 53248,100: POKE 704,160: POKE 53256,2 
30 MEM = PEEK (10 6) - 8 

40 POKE 54279, MEM: POKE 53277,3: START = MEM * 256 + 1024 

50 For Loop = 100 To 119: Read Byte: POKE START + Loop, Byte: Next Loop 

60 DATA 16, 16, 56, 40,40,56, 40, 40,40 

70 DATA 124,84,124,84,254,146,254,170,170,68 

100 End 

You can change the color, width, resolution, and horizontal 
Position of the player in the example by altering the registers 
used above. 

Each player is one byte (eight bits) wide. Single line resolution 
P/M characters (POKE 559,62) can be up to 256 bytes high. 

Double line resolution P/M characters (POKE 559,46) can be up 
to 128 bytes high. In either case, they can map to the height of the 
screen. Missiles have the same height, but are only two bits wide 
each. Four missiles can be combined into a fifth player by setting 
BIT 4 of location 623 ($26F). You need not fill the entire height of 
a P/M character, but you should POKE unused bytes with zero to 
eliminate any screen garbage. You can do this by: 

For N = PMBASE + 1024 To PMBASE + 2048:POKE N,0: Next N 

where PMBASE is the starting address of the reserve memory 
area. In double line resolution, change the loop value to N = 

PMBASE + 512 TO PMBASE + 1024. Here's a short machine 
language routine to do the same thing. You would put the Start 
address of the area to be loaded with zero and the number of 
bytes to be cleared in with the USR call as the first two 
Parameters. In this example, I have arbitrarily chosen 38012 and 
2048 for these values. 

10 START = 38012: Byte = 2048: DIMPGM$(42) 

20 For Loop = 1 To 42: Read ML: PGM$(Loop, Loop) = CHR$(ML): Next Loop 
30 DATA 104,104,133,204,104,133,203,104,133,206,104 

40 DATA 133,205,166, 206, 160,0, 169, 0,145, 203,136 

50 DATA 208,251,230,204,202,48,6,208,244,164 

60 DATA 205,208,240,198,204,160,0,145,203,96 
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70 A = USR(ADR(PGM$), START, Byte) 


You can use this routine to clear out memory anywhere in the 
Atari. You can also use it to load any one value into memory by 
changing the second zero (after the 169) in line 40 to the value 
desired. 

Locating your graphics tables at the high end of memory may 
cause addressing problems for playfield graphics, or may leave 
some of the display unusable and cause PLOT to malfunction. If 
you locate your tables just betöre the screen display, it may be 
erased if you change graphics modes. You can look at your 
highest RAM use graphics Statement and plan accordingly. To 
calculate a safe starting address below the display list, try: 

100 DLIST = PEEK(560) + PEEK(561) * 256: PMBASE = INT (DLIST/SIZE -1) 

where SIZE is 2048 for single line resolution, 1024 for double 
line. 

Once you have the starting address, determine the ending 
address of your table by adding the correct number of bytes for 
the size (same as the SIZE variable above), and POKE this 
number (LSB/MSB) into APPMHI at locations 14 and 15 ($E, $F). 

This sets the lower limit for playfield graphics memory use. If you 
change graphics modes in the program now, it should leave your 
player tables intact. For example, if the DL is at 39968, the 
PMBASE will equal 36864 in the equation above. Add 2048 
(single line resolution) to get 38912. This is $9800. In decimal, 
the LSB is zero and the MSB is 152. POKE these values into 
APPMHI. This sets the lowest limit to which the screen and DL 
data may descend. 

The unused portion of the RAM set aside for P/M use, or any 
RAM reserved for players, but not used, may be used for other 
purposes in your program such as machine language routines. 

See the appendix for a map of P/M memory use. The register 
Stores the address as below: 

Bit 76543210 

One Line resolution: .MSB.unused. . . 

Two Line resolution: .MSB. unused.. 

There are some restrictions on locating your P/M data above the 
display list. If not positioned far enough above your screen data, 
you may end up with both the normal and screen data being 
displayed at once, resulting in garbage on the screen. A display 
list may not cross a 1K boundary without a jump instruction, and 
the screen display RAM cannot cross a 4K boundary without an 
LMS instruction to point to the proper byte(s). Due to problems 
that arise when moving the GR.7 and GR.8 screens and data less 
than 4K, you should never reserve less than 16 pages above 
RAMTOP in these modes. If you are reserving more, add the 
pages in blocks of 4K (16 pages). 

See COMPUTEI, September 1981, for a discussion of the 
problems of positioning P/M graphics in memory, and using P/M 
graphics for animation. 

See De Re Atari, COMPUTEI, June 1982, and Creative 
Computing, April 1982, for a discussion of using string 
manipulation with P/M graphics. See Your Atari 400/800 for a 
general discussion of P/M graphics. Most of the populär 
magazines have also carried articles on simplifying P/M 
graphics. 


* SIZE 
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54280 D408 
Unused. 

54281 D409 CHBASE 

(W) Character base address; the location of the Start of the 
character set, either the Standard Atari set or a user-designed set. 
The default is 224 ($E0), which points to the Start of the Atari 
ROM character set. Iridis, a short-lived disk -and- documentation 
magazine, produced a good Utility called FontEdit to aid in the 
design of altered character sets. Online Systems' program The 
Next Step is also very useful for this purpose, as is COMPUTEI's 
"SuperFont," January 1982. Uses shadow register 756 ($2F4). 
Normally, this points to location 57344 or 57856 ($E000 or $E200) 
depending on your choice of characters used in which text mode. 
GRAPHICS mode zero uses the entire 128-character set; GR.1 
and GR.2 use only half the set (64 characters). You POKE a 
different number into the shadow register at 756 ($2F4) to point to 
your own character set in RAM. This must be an even number 
that points to a page in memory that is evenly divisible by two. In 
GR.i and GR.2 this number is 224 (pointing to $E000), giving 
you uppercase, punctuation and numbers. POKEing the shadow 
or this location (in machine language) with 226 will give you 
lowercase and control characters. 

See the Information about the ROM character set at 57344 
($E000). 

54282 D40A WSYNC 

(W) Wait for horizontal synchronization. Allows the OS to 
synchronize the vertical TV display by causing the 6502 to halt 
and restart seven machine cycles betöre the beginning of the 
next TV line. It is used to synchronize the VBI's or DLl's with the 
screen display. 

To see the effect of the WSYNC register, type in the second 
example of a Display List Interrupt at location 512. RUN it and 
observe that it causes a clean Separation of the colors at the 
change boundary. Now change line 50 to: 

50 DATA 72,169,222,234,234,234,141,24,208,104,64 

This eliminates the WSYNC command. RUN it and see the 
difference in the boundary line. 

The keyboard handler sets WSYNC repeatedly while generating 
the keyboard click on the console Speaker at 53279 ($D01 F). 
When interrupts are generated during the WSYNC period, they 
get delayed by one scan line. To bypass this, examine the 
VCOUNT register below and delay the interrupt Processing by 
one line when no WSYNC delay has occurred. 

54283 D40B VCOUNT 

(R) Vertical line counter. Used to keep track of which line is 
currently being generated on the screen. Used during Display 
List Interrupts to change color or graphics modes. PEEKing here 
returns the line count divided by two, ranging from zero to 130 
($82; zero to 155 on the PAL System; see 53268; $D014) for the 
262 lines per TV frame. 

54284 D40C PENH 

(R) Light pen horizontal Position (564). Holds the horizontal color 
clock count when the pen trigger is pressed. 

54285 D40D PENV 
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(R) Light pen vertical Position (565). Holds the VCOUNT value 
(above) when the pen trigger is pressed. See the Hardware 
Manual, p. 11-32, for a description of light pen Operation. 

54286 D40E NMIEN 

(W) Non-maskable Interrupt (NMI) enable. POKE with 192 to 
enable the Display List Interrupts. When BIT 7 is set to one, it 
means DL instruction interrupt; any display list instruction where 
BIT 7 equals one will cause this interrupt to be enabled at the 
Start of the last Video line displayed by that instruction. When BIT 
6 equals one, it allows the Vertical Blank Interrupt and when BIT 
5 equals one, it allows the RESET button interrupt. The RESET 
interrupt is never disabled by the OS. You should never press 
RESET during powerup since it will be acted upon. 

NMIEN is set to 64 ($40) by the OS IRQ code on powerup, 
enabling VBI's, but disabling DLl's. All NMI interrupts are 
vectored through 65530 ($FFFA) to the NMI Service routine at 
59316 ($E7B4) to determine their cause. 

Bit 7 6 5 43210 

Interrupt: DLI VBI RESET .... unused 

54287 D40F NMIRES 

(W) Reset for NMIST (below); clears the interrupt request 
register; resets all of the NMI Status together. 

NMIST 

(R) NMI Status; holds cause for the NMI interrupt in BITs 5, 6 and 
7; corresponding to the same bits in NMIEN above. If a DLI is 
pending, a jump is made through the global RAM vector 
VDSLST (512; $200). The OS doesn't use DLl's, so 512 is 
initialized to point to an RTI instruction and must be changed by 
the user betöre a DLI is allowed. 

If the interrupt is not a DLI, then a test is made to see if the 
interrupt was caused by pressing RESET key and, if so, a jump is 
made to 58484 ($E474). If not a RESET interrupt, then the System 
assumes the interrupt was a VBLANK interrupt, and a jump is 
made through VVBLKI at 546 ($222), which normally points to 
the stage one VBLANK processor. From there it checks the flag at 
CRITIC (66; $42) and, if not from a critical section, jumps 
through VVBLKD at 548 ($224), which normally points to the 
VBLANK exit routine. On powerup, the VBLANK interrupts are 
enabled while the display list interrupts are disabled. See the end 
of the memory map for a description of the VBLANK procedures. 

For IRQ interrupts, see location 53744 ($D20E). 

4.8.6.9 54288 - 54303 

Locations 54288 to 54303 ($D410 to $D41 F) are repeats of locations 54272 to 54287 ($D400 to 
$D40F). 

4.8.6.10 54784-55295 

Locations 54784 to 55295 ($D600 to $D7FF) are unused but not empty nor user alterable. See the 
note at 53504 ($D100). 
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4.8.7 55296 - 65535 OS ROM 

OPERATING SYSTEM ROM 

Locations 55296 to 65535 ($D800 to $FFFF) are the OS ROM. These locations are contained in 
the 10K ROM cartridge, which sits in the front slot of the Atari 800 or inside the Atari 400. The OS 
is identical for both Computers. 

The locations given here are for the "A" Version of the OS ROMs. There are changes in the new 
"B" Version ROMs, which are explained in the appendix. Most of the changes affect the interrupt 
handler routines and SIO. In making these changes, Atari cured some bugs such as the device 
time-out problem. Unfortunately, there is a cloud with this silver lining: not all of your old Software 
will run with the new ROMs. Megalegs, one of my favorite games, cannot run under the new 
ROMs. A pity that. There are others; l'm sure you'll find them. The solution is to have both sets of 
ROMs so you can use all of your Software. 

4.8.7.1 55296 - 57343 Floating Point 

FLOATING POINT PACKAGE ROM 

Locations 55296 to 57343 ($D800 to $DFFF) are reserved for the ROM's Floating Point 
Mathematics Package. There are other areas used by the FP package: page zero (locations 212 to 
254; $D4 to $FE) and page five (locations 1406 to 1535; $57E to $5FF), which are used only if FP 
routines are called. There are also trigonometric functions in the BASIC cartridge located between 
48549 and 49145 ($BDA5 to $BFF9) which use the FP routines. See De Re Atari for more 
information. 

These are the entry points to some of the subroutines; unless otherwise noted, they use FP 
register zero (FR0 at 212 to 217, $D4 to $DB): 

DECIMAL HEX LABEL 

55296 D800 AFP 

ASCII to Floating Point (FP) conversion. 

55526 D8E6 FASC 
FP value to ASCII conversion. 

55722 D9AA IFP 

Integer to FP conversion. 

55762 D9D2 FPI 

FP to integer conversion. 

55876 DA44 ZFR0 

Clear FR0 at 212 to 217 ($D4-$DB) by setting all bytes to zero. 

55878 DA46 ZF1 

Clear the FP number from FR1, locations 224 to 229 ($E0 to $E5), 
by setting all bytes to zero. Also called AF1 by De Re Atari. 

55904 DA60 FSUB 

FP subtract routine, the value in FR0 minus the value in FR1. 

55910 DA66 FADD 

FP addition routine; FR0 plus FR1. 

56027 DADB FMUL 

FP multiplication routine; FR0 times FR1. 

56104 DB28 FDIV 
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FP division routine; FRO divided by FR1. 

56640 DD40 PLYEVL 

FP polynomial evaluation. 

56713 DD89 FLDOR 

Load the FP number into FRO from the 6502 X,Y registers. 

56717 DD8D FLDOP 

Load the FP number into FRO from user routine, using FLPTR at 
252 ($FC). 

56728 DD98 FLD1R 

Load the FP number into FR1 from the 6502 X,Y registers. 

56732 DD9C FLD1P 

Load the FP number into FR1 from user program, using FLPTR. 

56743 DDA7 FSTOR 

Store the FP number into the 6502 X,Y registers from FRO. 

56747 DDAB FSTOP 

Store the FP number from FRO, using FLPTR. 

56758 DDB6 FMOVE 

Move the FP number from FRO to FR1. 

56768 DDCO EXP 
FP base e exponentiation. 

56780 DDCC EXP10 
FP base 10 exponentiation. 

57037 DECD LOG 
FP natural logarithm. 

57041 DED1 LOGIO 
FP base 10 logarithm. 

4.8.7.2 57344 - 58367 Character set 

Locations 57344 to 58367 ($E000 to $E3FF) hold the Standard Atari character set: at $E000 the 
special characters, punctuation and numbers begin; at $E100 (57600) the Capital letters begin; at 
$E200 (57856) the special graphics begin, and at $E300 (58112) the lowercase letters begin. 

There are 1024 bytes here ($400), with each character requiring eight bytes, for a total of 128 
characters (inverse characters simply manipulate the information here to reverse the bits by 
performing an OR with 128 - the value in location 694 ($2B6) when the Atari logo key is toggled - 
on the bits. To return to the normal ATASCII display, the inverse characters are EORed with 128). 
The first half of the memory is for numerals, punctuation, and uppercase characters; the second 
half ($E200 to $E3FF) is for lowercase and control characters. When you POKE 756 ($2F4) with 
224 ($E0), you are POKEing it with the MSB of this address ($E000). When you POKE it with 226 
($E2), you are moving the address pointer to the second half of the character set. In GR.0, you 
have the entire character set to use. In GR.1 and GR.2, you can use only one half of the set at a 
time. You can't POKE it with 225 because the number POKEd must be evenly divisible by two. 

The characters stored here aren't in ATASCII Order; they have their own internal Order for storage. 
The order of the characters is listed on page 55 of your BASIC Reference Manual. 

Here's an example of how a letter (A) is stored in ROM. Each line represents a byte. The decimal 
values are those you'd find if you PEEKed the eight locations where "A" is stored (starting at 
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57608; $E108): 


76543210 

Decimal 

+ - 

-+ 

00000000 

0 

1 


00011000 

24 


## 

00111100 

60 

1 

#### 

01100110 

102 

1 

## ## 

01100110 

102 

I 

## ## 

01111110 

126 

1 

###### 

01100110 

102 

1 

## ## 

00000000 

0 

1 



+-+ 


When you create your own character sets (or alter the Atari set 
when you move it to RAM - see location 756; $2F4 for a routine 
to do this), you do a "bit-map" for each character as in the 
example above. It could as easily be a spaceship, a Hebrew 
letter, an APL character, or a face. Chris Crawford's game 
Eastern Front 1941 (APX) shows excellent use of an altered 
character set to create his large map of Russia, plus the Symbols 
for the armies. 

Here's an example of using the bit-mapping of the character set 
to provide text in GRAPHICS 8: 

1 GRAPHICS 8 

5 DLIST = PEEK(560) + PEEK(561)*256 

6 LOBYTE = DLIST+4: HIBYTE = DLIST +5 

7 REAL = PEEK(LOBYTE) + PEEK(HIBYTE)*256: SCREEN = REAL: TV = SCREEN 
10 CHBASE = 57344 

20 Dim A$ (128) , Byte (128) ,WANT(128) 

27 Print "INPUT A 40 CHARACTER STRING:" 

30 Input A$ 

35 TIME = TIME + 1 
40 For LOOK = 1 To Len(A$) 

50 Byte (LOOK) = ASC(A$(LOOK,LOOK)) 

51 If Byte (LOOK) > 127 Then Byte (LOOK) = Byte (LOOK) - 128 

52 If Byte (LOOK) < 32 Then Byte (LOOK) = BVTE(LOOK) + 64: GoTo 55 

53 If Byte (LOOK) < 97 Then BVTE(LOOK) = Byte (LOOK) - 32 
55 Next LOOK 

59 For EXTRA = 0 To 7 

60 For LOOK = 1 To Len(A$) 

70 WANT(LOOK) = PEEK(CHBASE + EXTRA+ Byte (LOOK)*8) 

80 POKE TV + EXTRA, WANT(LOOK): TV = TV + 1 
82 Next LOOK 

85 SCREEN = SCREEN +39: TV = SCREEN 
90 Next EXTRA 

100 SCREEN = REAL + TIME*320 

110 If SCREEN > REAL + 6080 Then TIM E = 0: GoTo 100 
120 GoTo 30 


This program simply takes the bytes which represent the letters 
you input as A$ and finds their places in the ROM character set. 

It then proceeds to POKE the bytes into the screen RAM, using a 
FOR-NEXT loop. 


To convert ATASCII codes to the internal codes, use this table: 


ATASCII value 

0 — 31 

32 — 95 

96 — 127 

128 — 159 
160 — 223 
224 — 255 


Operation For 
internal code 
add 64 

subtract 32 
remains the same 
add 64 

subtract 32 
remains the same 


See COMPUTEI, November 1981, for the program "TextPlot" 
which displays text in different sizes in GRAPHICS modes three 
to eight, and January 1982 for a program to edit character sets, 
"SuperFont." 
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4.8.7.3 58368 - 58447 Vector tables 

Locations 58368 to 58447 ($E400 to $E44F) are the vector tables, stored as LSB, MSB. These 
base addresses are used by resident handlers. Händler vectors use the following format: 

Open vector 
Close vector 
Get Byte vector 
PUT Byte vector 
Get STATUS vector 
SPECIAL vector 

Jump To handler initialization routine (JMP LSB/MSB) 

The device tables in location 794 ($31A) point to the particular vector(s) used in each appropriate 
table. In each case, the 6502 X register is used to point to the originating IOCB. 

DECIMAL HEX LABEL 

58368 E400 EDITRV 

Screen Editor (E:) entry point table. 

58383 E40F 

If you PEEK here and get back 56, then you have the older "A" 

Version of the OS ROMs. If you get back zero, then you have the 
newer "B" Version that was released in January 1982. The "B" 

Version fixes some minor bugs, including the device time-out 
Problems, enables POKEY timer tour, and provides a vector for 
BREAK key Interrupts. See Appendix 4. 

58384 E410 SCRENV 

Display handler (television screen) (S:). 

58400 E420 KEYBDV 

Keyboard handler (K:). 

58416 E430 PRINTV 

Printer handler (P:). 

58432 E440 CASETV 

Cassette handler (C:). 

4.8.7.4 58448 - 58533 

Locations 58448 to 58533 ($E450 to $E4A5) are more vectors: those to location 58495 ($E47F) 
are Jump vectors, those from 58496 to 58533 ($E480 to $E4A5) are the initial RAM vectors. 

DECIMAL HEX LABEL 

58448 E450 DISKIV 

Disk handler initialization vector, initialized to 60906 ($EDEA). 

58451 E453 DSKINV 

Disk handler (interface) entry; checks the disk Status. Initialized 
to 60912 ($EDF0). 

58454 E456 CIOV 

Central Input/Output (CIO) utility entry. CIO handles all of the 
I/O operations or data transfers. Information placed in the 
lOCB's teils CIO what operations are necessary. CIO passes this 
information to the correct device driver routine and then passes 
control to the Device Control Block (DCB). This in turn calls up 
SIO (below) to control the actual peripheral(s). CIO treats all I/O 
in the same manner: device independent. The differentiation 
between operations is done by the actual device drivers. 


Converted and layouted 2006 by Andreas Bertelmann for ABBUC 






139 Mapping the Atari 


You jump to here to use the IOCB handler routines in ROM. 

BASIC Supports only record I/O or one-byte-at-a-time I/O (GET 
and PUT). Addressing CIOV directly will allow the user to input 
or output a buffer of characters at a time, such as loading a 
machine language program directly into memory from a disk file. 
This is considerably faster than using BASIC functions such as 
GET. Here is a typical machine language subroutine to do this: 

PLA, PLA, PLA, TAX, JMP $E456 

(104,104, 104,170,76, 86, 228) 

($68,$68,$68,$AA,$4C,$56,$E4) 

This gets the IOCB number into the 6502 X register and the 
return address on the stack. CIOV expects to find the IOCB 
number 16 in the 6502 X register (i.e., IOCB zero is zero, IOCB 
one is 16; $10, IOCB two is 32, $20, etc.). $E456 is the CIO 
initialization entry point (this address). 

To use CIOV in a program, first you must have OPENed a 
channel for the appropriate actions, POKEd the correct IOCB 
(locations 848 to 959; $350 to $3BF) with the correct values, and 
established a location in which to load your file (IOCB address 
plus four and plus five). One use is calling up a high-res picture 
from a disk and storing it in the screen memory (locations 88, 89; 
$58, $59). You can POKE the appropriate decimal values into 
memory and call it with a USR call, or make it into a String 
(START$ = "hhh*LVd" where the * and the d are both inverse 
characters) and call it by: 

JUMP = USR(ADR(START$)) 

This method is used to Start the concurrent mode in the RS-232 of 
the 850 interface in the 850 Interface Manual. See location 88, 89 
($58, $59) for another example of the machine language routine 
technique. Still another use of this method can be found in De Re 
Atari. Initialized to 58564 ($E4C4). 

58457 E459 SIOV 

Serial Input/Output (SIO) Utility entry point. SIO drives the 
serial bus and the peripherals. When a request is placed in the 
Device Control Block (DCB) by a device handler, SIO takes 
control and uses the data in the DCB to perform the Operation 
required. SIO takes care of the transfer of data as defined by the 
DCB. CIO (above) is responsible for the "packaging" of the data 
and transfers control to SIO when necessary. See the DCB 
locations 768 to 779 ($300-$30B). 

SIO first sends a command frame to the device, consisting of five 
bytes: the device ID, the command BYTE, two auxiliary bytes for 
device-specific information, then a checksum (which is the sum 
of the first four bytes). If the device acknowledges this frame, it is 
followed, if necessary, by the data frame of a fixed number of 
bytes depending on the device record size, plus a checksum 
byte. Initialized to 59737 ($E959). 

58460 E45C SETVBV 

Set System timers during the VBLANK routine. Uses the 6502 X 
register for the MSB of vector/times, Y for the LSB and A for the 
number of the vector to hack (change). SETVBV insures that both 
bytes of the vector addressed will be updated while VBLANK is 
enabled. You can JSR here when creating your own timer 
routines. See COMPUTER November 1981, for an application. 
Initialized to 59666 ($E912) old ROMs, 59629 ($E8ED) new 
ROMs. 
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58463 E45F SYSVBV 

Stage one VBLANK calculations entry. It performs the 
Processing of a VBLANK interrupt. Contains JMP instruction for 
the vector in the next two addresses (58464, 58465; $E460, 
$E461). This is the address normally found in VVBLKI (546, 547; 
$222, $223). It is initialized to 59345 ($E7D1), which is the 
VBLANK routine entry. Initialized to 59345 ($E7D1) old ROMs, 
59310 ($E7AE) new ROMs. 

58466 E462 XITVBV 

Exit from the VBLANK routine, entry point. Contains JMP to the 
address stored in next two locations (58467, 58468; $E463, 
$E464). This is the address normally found in VVBLKD (548, 549; 
$224, $225). Initialized to 59710 ($E93E), which is the VBLANK 
exit routine. It is used to restore the Computer to its pre-interrupt 
state and to resume normal Processing. Initialized to 59710 
($E93E) old ROMs, 59653 ($E905) new ROMs. 

58469 E465 SIOINV 

SIO utility initialization, OS use only. 

58472 E468 SENDEV 

Send enable routine, OS use only. 

58475 E46B INTINV 

Interrupt handler initialization, OS use only. 


58478 E46E CIOINV 

CIO utility initialization, OS use only. 

58481 E471 BLKBDV 

Blackboard mode entry. Blackboard mode is the "ATARI MEMO 
PAD" mode. It can be reached from BASIC by typing "BYE", 

"B." or by powering up with no peripherals or cartridges. 

Nothing you write to the screen in blackboard mode is acted 
upon by the Computer. You can enter this mode to protect your 
programs temporarily from prying and curious fingers. 

All of the screen editing commands continue to work in 
blackboard mode. You can enter blackboard mode from any 
graphics mode with a text window; the display screen will remain 
intact on the screen while the text window will be in blackboard 
mode. Pressing RESET will, of course, return the entire screen to 
GR.O. You can also enter blackboard mode from a program, but 
cannot get out of it in BASIC once you are in it. 

If you entered blackboard mode from BASIC, you can return to it 
by pressing RESET. Any BASIC program will still be there. So 
will any RS-232 or DOS handlers previously booted. Initialized to 
61987 ($F223). 

58484 E474 WARMSV 

Warmstart entry point (RESET button vector). Initializes the OS 
RAM region. The RESET key produces an NMI interrupt and a 
Chip reset (see below). Jump to here on an NMI caused by 
pressing the RESET key. Initialized to 61723 ($F11B). 

58487 E477 COLDSV 

Coldstart (powerup) entry point. Initializes the OS and user RAM 
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regions; wipes out any program in memory. Initialized to 61733 
($F125). 

58490 E47A RBLOKV 

Cassette read block routine entry, OS use only. 

58493 E47D CSOPIV 

Cassette OPEN for input vector, OS use only. 

58496 E480 VCTABL 

RAM vector initial value table. 


4.8.7.5 58534 - 65528 

The following are the addresses for the handler routines: 

DECIMAL HEX LABEL 

58534-59092 E4A6-E6D4 CIOORG are Addresses for the Central Input/Output routines 

(CIO): 

58534 ($E4A6) CIOINT is the CIO initialization routine called by the monitor on powerup. 

58577 ($E4D1); move the user IOCB to the ZIOCB. 

58596 ($E4E4); check for a valid command. 

58633 ($E509); OPEN command routines. 

58675 ($E533); CLOSE command routines. 

58702 ($E54E); STATUS and special command routines. 

58729 ($E569) CIREAD; process the CIO commands for read and write, including buffer check for 
full or empty. 

58907 ($E61 B); routine to return to the user from CIO. 

58941 ($E63D), routines to compute the device handler entry point, jump to the handler, transfer 
control, and then return to CIO after the Operation. 

59093-59715 E6D5-E943 INTORG Addresses for the interrupt handler routines: 

59123 ($E6F3) PIRQ; IRQ interrupt Service routines Start here. 

59126 ($E6F6); the immediate IRQ vector to the IRQ handler. The global NMI and IRQ RAM 
vectors in locations 512 to 527 ($200 to $20F) are all initialized to this area (59142, $E706 for the 
new OS ROMs). 

59314 ($E7B2); the vector for the IRQ interrupts on powerup; it points to a PLA and RTI instruction 
sequence (new OS ROMs; 59219; $E78F). 

59316 ($E7B4) PNMI; the NMI handler, tests for the reason for the NMI, then jumps through the 
appropriate RAM vector. Also called the Interrupt Service Routine (ISR). 

59345 ($E7D1) SYSVBL; the VBLANK routines Start here, including frame counter, update timer, 
update hardware registers from shadow registers, update the attract mode counter and the 
realtime clock. The vertical blank immediate vector, VVBLKL1, normally pointed to by locations 
546, 547 ($222, $223), points to here. The Updated OS ROMs point to 59310 ($E7AE). 


Converted and layouted 2006 by Andreas Bertelmann for ABBUC 







Memory map 142 

1 


59666 ($E912) SETVBL; subroutines to set the VBLANK timers and vectors. 

The vertical blank deferred Interrupt, normally vectored from locations 548, 549 ($224, $225), 
points to 59710 ($E93E). In the Updated OS ROMs, it points to 59653 ($E905). In both cases they 
point to the VBLANK exit routine. See page 104 of the OS User's Manual for a list of the vectors 
and MICRO, January 1982, for an explanation of the VBLANK process. 

59716-60905 E944-EDE9 SIOORG Routines for the Serial Input/Output (SIO) routines: 

60011 ($EA6B) SEND; is the SIO send buffer routine entry. 

60048 ($EA90) ISRODN, is the serial output ready IRQ vector. 

60113 ($EAD1) ISRTD; is the serial output complete IRQ vector. This is at 60111 ($EACF) in the 
new OS ROMs. 

60177 ($EB11) ISRSIR; is the serial input ready IRQ vector. This is 60175 ($EB0F) in the new OS 
ROMs. 

60292 ($EB84) CASENT; is the Start of the cassette handling code SIO subroutine to set baud 
rate, tone values, inter-record gap, to load the buffer from the cassette and to turn on the recorder 
motor. Write routines are located in 61249 to 61666 ($EFF5 to $F0E2). 

60515 ($EC63) is the Start of the disable POKEY interrupts routine entry, which also disables the 
send and receive functions. 

60583 ($ECA7) COMPUT; is the subroutine to calculate baud rate using the POKEY frequency 
registers and the VCOUNT timer. The tables for the AUDF and VCOUNT values are between 
60882 and 60905 ($EDD2 and $EDE9). 

60906-61047 EDEA-EE77 DSKORG Routines for the disk handler. Initialization is at DINIT, 
60906 ($EDEA), entry is at DSKIF, 60912 ($EDF0). 

61048-61248 EE78-EF40 PRNORG Routines for the printer handler. 

61249-61666 EF41-F0E2 CASORG Routines for the cassette handler. 

The buzz used in the cassette CLOAD command can be called up from BASIC by: 

BUZZ = USR(61530). 

You can turn it off with the RESET key. While this isn't terribly exciting, it points to the potential of 
using the console Speaker for sound instead of merely for beeps (the RAM location for the Speaker 
is at 53279; $D01 F). See the Speaker location and COMPUTER August 1981, for a short routine to 
use the Speaker for sound effects. 

61667-62435 F0E3-F3E3 MONORG Routines for the monitor handler. This is also the 

address area of PWRUP, the powerup module (61733; $F125). Coldstart routines are initialized to 
this location. The routine to check for cartridge installation begins at 61845 ($F195). Hardware 
initialization begins at 62081 ($F281). 

61723 ($F11B) RESET; the RESET button routine Starts here. 

62081 ($F281) HARDI, the Start of the hardware initialization routines. 

62100 ($F294) OSRAM; the Start of the OS RAM initialization and Setup routines. 

62159 ($F2CF) BOOT; the entry point for the disk boot routine. 

62189 ($F2ED) DOBOOT; the disk boot routine activation. 
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62334 ($F37E) DOPEN; the entry point for the reinitialization of disk Software. 

62436-65535 F3E4-FFFF KBDORG 

Routines for the display and keyboard handler. The display 
handler beqins at 62454 ($F3F6) and the keyboard handler 
begins at 63197 ($F6DD), below. 

63038 F63E EGETCH 

Like the BASIC INPUT command, EGETCFI gets a line from the 
screen and keyboard, but only one character at a time. You must 
do a JSR $F63E for each character input. This is also the address 
of the beginning of the screen editor routines. 

63140 F6A4 EOUTCH 

This routine puts the character currently in the accumulator onto 
the screen in the next print location. Similar to the BASIC PUT 
command. 

63197 F6DD KGETC2 

Beginning of the keyboard handler. 

63202 F6E2 KGETCH 

This routine waits for a key to be pressed and returns its value to 
the accumulator (6502 register A). Similar to the BASIC GET 
command. 

64428 FBAC SCROLL 

The screen scroll routine Starts here. 

64764 FC FC DRAW 

Screen draw routines begin here, end at 65092 ($FE44). See 
Creative Computing, March 1982, for an example of a 
modification to the draw routines to avoid the "out-of-bounds" 
error for use in GR.7+. 

65093-469 FE45-FFBD 

The ROM tables for display lists, ANTIC codes, control codes, 
and ATASCII conversion codes. 

65470 FFBE PIRQQ 

Subroutines to test the acceptance of the last key pressed and to 
process the debounce delay routines Start here. 

When a key is pressed, it initiates an IRQ through VKEYBD at 
locations 520, 521 ($208, $209) to 65470 ($FFBE). This is the 
keyboard Service routine. It processes debounce, and SFIIFT- 
CTRL logic (see location 559; $22F); saves the internal keyboard 
code in 754 ($2F2) and 764 ($2FC); sets the ATTRACT mode flag 
at 77 ($4D) and sets location 555 ($22B - SRTIMR) to 48 ($30). 

65528 FFF8 CHKSUN 

According to Softside Magazine, December 1981, if a PEEK here 
returns 255, then you have the older OS ROM(s). There were 
some troubles with cassette loads in the older ROMs that 
sometimes require the following to eure: 

Do an LPRINT without a printer attached before CLOAD. This 
clears the cassette buffer. 

Press RESET before CSAVEing or CLOADing will restore the 
System to its initialization parameters and help with loading and 
saving routines. 
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There is a new OS available from Atari which fixes a bug that 
would cause the I/O operations to "time out" for a few seconds. It 
apparently does not alter any of the routines mentioned here. 

The Chip reset interrupt (powerup) vectors through location 
65532 ($FFFC) to 58487 ($E477) where a JMP vector to the 
powerup routine is located. A Chip reset is not the same as 
pressing the RESET key, which in itself does not generate a Chip 
reset. 

The NMI Interrupts are vectored through 65530 ($FFFA) to the 
NMI Service routine (ISR) at 59316 ($E7B4), and all IRQ 
interrupts are vectored through 65534 ($FFFE) to the IRQ Service 
routine at 59123 ($E6F3). In these Service routine areas, the 
cause of the interrupt is determined, and the appropriate action 
is taken, either by the OS or through a JMP to a RAM vector 
where a user routine exists. 
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5 Appendix 1 - VBLANK Processes 

The VBLANK routines are all documented in the OS listings, pages 35 to 38. In the "A" ROMs, they 
are processed in locations 59345 to 59665 ($E7D1 to $E911). In the "B" ROMs, they are 
processed at 59310 to 59628 ($E7AE to $E8EC). See also De Re Atari for more explanation. 

Stage 1 VBLANK: 

Performed every VBI: 

1) Increment the realtime clock at 18 - 20 ($12-$14) 

2) Process the attract mode variables (location 77; $4D) 

3) Decrement System timer one at 536 ($218) and if zero JSR through 550 ($226). 

Stage 2 VBLANK: 

Performed every VBI which does not Interrupt critical sections: 

1) Update the hardware registers from the shadows as follows: 


Shadow: 

Hardware: 

Update reason: 

SDLISTL/H 

DLISTL/H 

DISPLAY LIST End 

SDMCTL 

DMACTL 


CHBAS 

CHBASE 


CHACT 

CHACTL 


GPRIOR 

PRIOR 


COLORO-4 

COLPFO-4,BAK 

ATTRACT MODE 

PCOLO-3 

COLPMO-3 


LPCNV/H 

PENV/H 

LIGHT PEN 

STICK0-1 

PORTA 

JOYSTICKS 

PTRIGO-3 

PORTA 

PADDLE TRIGGERS 

STICK2-3 

PORTB 


PTRIG4-7 

PORTB 


PADDLO-7 

POTO-7 

PADDLES 

STRIGO-3 

TRIGO-3 

JOYSTICK TRIGGERS 


CONSOL 

CONSOLE SPEAKER OFF 


2) System timers two to five (locations 540,542,544; $21C,$21 E,$220) are decremented and if the 
value is zero, the corresponding flags are set. A JSR is made through 552 ($228) if timer two 
equals zero. 

3) A character is read from POKEY keyboard register at 53769 ($D209) and read into CH at 764 
($2FC) if the auto-repeat is active. 

4) The keyboard debounce counter is decremented by one if it is not zero and if no key is being 
pressed. 

5) Keyboard auto-repeat logic is processed. 

6) Exit the VBLANK routine through 58466 ($E462). 
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6 Appendix 2 - Graphics Memory Map 

This diagram is not to scale; it is merely meant to give you a visual idea of the structure of the Atari 
memory. The numhers on the right are the memory pointers: these locations point to the 
addresses shown. The numhers on the left are the actual locations in memory. 


Location 

4 

65535 

Contents 

Top of memory 


Pointers 

-+ 

i 


Operating System ROM 




i 

60906-65535 

Device handler routines 


794-831 

HATABS 

i 

59716-60905 

Serial Input/Output (SIO) 

Utilities 




59093-59715 

Interrupt handler 


512,513 

VDSLST 

i 




514-527 

Vectors 

i 

58534-59092 

Central Input/Output (CIO) 

Utilities 


i 

58533 

Operatinq System vectors 




1 

58496-58533 

Initial RAM vectors On powerup 



i 

58448-58495 

JMP vectors 




i 

58432-58447 

Cassette 




i 

58416-58431 

Printer 




i 

58400-58415 

Keyboard 




i 

58384-58399 

Screen 




i 

58368-58383 

Editor 




i 

58367 

ROM Character Set 


756 CHBAS 

1 

57344 





i 

i 

57343 

Floating Point ROM package 




i 

552 95 

I/O Chips 




i 

54784-55295 

Unused 




i 

i 

i 

54272-54783 

ANTIC 


756 

CHBAS 

i 




755 

CHI 

i 




564-565 

LPEN 

i 




560-561 

SDLSTL 

i 




559 

SDMCTL 

i 

54016-54271 

PIA 


636-639 

PTRIG# 

i 




632-635 

STICK# 

i 

53760-54015 

POKEY 


624-631 

PADDL# 

i 




562 

SSKCTL 

i 




16 

POKMSK 

i 

53504-53759 

unused 




i 

53248-53503 

GTIA Or CTIA 


704-707 

PCOLR# 

i 




708-712 

COLOR# 

i 




644-647 

STRIG# 

i 




623 GPRIOR 

i 

53247 

Unused 4K ROM block 




1 

49151 

8K BASIC ROM 




i 

i 


Or Left Cartridge (A) 




i 

40959 

Top of BASIC RAM Or 


106 

RAMTOP 

i 




740 

RAMSIZ 

i 


Right cartridge (B) ROM If 

present 



1 


(Atari 800 only) 




i 

i 

Size And 





i 

location 





i 

vary With 





i 

GRAPHICS 





i 

mode 





i 


Text window screen RAM 


60,661 TXTMSC 



40800 For GR.O 






Bottom of screen RAM 


88,89 

SAVMSC 

1 


40000 For GR.O 






Display List: 


560,561 

SDLSTL 

i 


39968 For GR.O 
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(OS) 

32768 

32767 


(13062) 


Size And 
location 
vary With 
program 
size 


(7420) 


6781 

6047 

5440 

5377 


1792 

1791 


Top Of BASIC RAM 


741,742 MEMTOP 


| User-program RAM _ 

| The amount of RAM can be ascertained by: Print FRE(O) 

I Bottom varies: see note below 
I Depends On buffer area allocated. 


RAM used by DOS And File System Manager 

144,145 MEMTOP 

Stack For For-Next & GoSub 142,143 RUNSTK 

14,15 APPMHI 


String & array table & 

End of BASIC program 140,141 STARP 


BASIC program area 

Statement table: 

Beginning of BASIC program 
Variable variable table 

VNTP + 1 

Variable name table 
BASIC bottom of memory 


Sector buffers 
Drive & sector buffers 
DOS vector 
DUP.SYS Start 

VTOC buffer 
DOS initialization 
Or BASIC RAM without 
DOS resident 
FMSRAM 

DUP.SYS beginning 

RAM used by OS And Cartridge. 
(To bottom of RAM) 


136,137 STMTAB 

134,135 WTP 

132,133 VNTD 

130,131 VNTP 

743,744 MEMLO 
128,129 LOMEM 

4921,4937 SABUFL/H 
4905,4913 DBUFA1/H 
10,11 DOSVEC 


12,13 DOSINI 
(743,744 MEMLO) 
(128,129 LOMEM) 


Page 

six RAM 


+- 


1535 

i 

RAM used by BASIC 



(To bottom of RAM) 

1406 


Floating Point RAM 

1405 

i 

BASIC RAM 


+- 

1151 | Operating System RAM 


+ 


+ 


512 

511 

256 

255 


Cassette buffer 
Printer buffer 
IOCB's 


Stack 


BASIC zero page RAM 
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1 _ 



1 

1 

1 

1 

I 

128 

1 

1 

1 

1 

1 

Floating Point pg. 0 

Assembler Cart. pg. 0 

i 

i 

i 

i 

i 


1 

127 


OS page zero RAM 

i 





Zero page IOCB 

i 


1 

0 

1 

Bottom of memory 

i 

— 

—+- 


- + - 


-+ 


Notes 

The bottom of the BASIC RAM depends on whether or not you have DOS files loaded in. Without 
DOS, LOMEM should be 1792, with DOS 7420. If you increase or decrease the number of disk 
and sector buffers by modifying DOS, this value will change again. See locations 743, 744 and 
1801,1802. 

The size and location of the variable, string and array tables depend on the program use and size. 
The more variables and arrays, the larger the memory the tables use. 

The size and address of the Display List and screen memory depend on the GRAPHICS mode in 
use. 

The first 256 bytes pointed to by LOMEM are the token output buffer. 

The actual BASIC program Starts at the address pointed to by VNTP. 
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7 Appendix 3 - Atari Timing Values 

clock frequency = 1.79 MHZ 
1 machine cycle = 0.558 usec. 

1 frame = 1/60 second 

scan lines = 262/frame 

color clocks = 228/scan line 
color clocks = 2/machine cycle 
machine cycles = 29868/frame 
machine cycles = 114/scan line 

VBLANK time = 7980 machine cycles or less, depending on GRAPHICS mode. The shortest 6502 
instruction requires two cycles; during that time the electron beam moves tour color clocks. 

Horizontal blank time: 

Wide playfield 18 machine cycles 
Normal playfield 34 machine cycles 
Narrow playfield 50 machine cycles 

See the Hardware Manual for more Information on cycle counting. 
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8 Appendix 4 - Old and New ROMs 

Old (A) And New (B) ROMS 

The new OS ROMs have been mentioned throughout the book. They fixed some of the earlier OS 
bugs, but also changed a few ROM locations in the process. The result is a better OS, but some of 
your earlier Software which calls up old ROM locations may not work with the new. 

There are two ways to test to see if you have the new or old ROMs; one is to PEEK location 58383, 
as described there. The other (the hardware solution) is to take out your ROM card, unscrew the 
metal top, and look inside. If the two Chips facing you on your left have an "A" after their first code 
number, you have the earlier ROMs. If they have a "B", lucky you. You have the latest ROMs. 

There is also the empirical test: if your drive times out during I/O operations, you've got the old 
ROMs. 

Here are the differences between the new and old ROM locations. There are also a number of 
changes made with the new ROMs to the vectors at locations 512 to 534, 546 to 549 and 550. 

Refer to those locations and the OS locations for more Information. The list below first specifies the 
old ROM locations, then the changes in the new ROMs. 

55296-57343 (FP package) same 

57344-58367 (character set) same 

58368-58477 (vector tables) are the same to 58459 ($E45B) where there are changes in the table 
between 58460-58466 ($E45C to $E462). 

58467-59092 ($E463-$E6D4) same 

59093 ($E6D5) is the Start of the IRQ handler. Changes to the new ROMs begin at 59126 ($E6F6) 
and continue to the end of the new IRQ handler at 59280 ($E790). 

59316 ($E7B4) is the NMI interrupt handler in the old ROMs, now Starts at 59281 ($E791). It is the 
same as the old Version except moved 35 bytes lower. 

59345 ($E7D1) is the Start of the VBLANK routines in the old ROMs; they now Start at 59310 
($E7AE) in the new ROMs. The routines remain the same until the SETVBL routine is reached at 
59666 ($E912) old ROMs, 59629 ($E8ED) new ROMs. The changes to the VBLANK routine are 
mostly to adjust for the shift in the new memory locations. 

58457 ($E459) is the SIO entry point for both versions. There are changes in the SIO routines to 
accommodate the new memory locations, but the entry point is still the same. 

60048 ($EA90) output data needed interrupt Service routine is changed, but the entry point is the 
same in both versions. 

60113 ($EAD1) the transmit done interrupt Service routine is the same, but has a new entry point at 
60111 ($EACF). 

60130 ($EAE2) the receive routine has some address changes and is moved to 60128 ($EAE0). 

60177 ($EB11) the serial input ready interrupt Service routine is the same, but the new entry point 
is 60175 ($EB0F). 

60222 ($EB3E) the SIO subroutines have some changes and a new entry point at 60220 ($EB3C). 

60270 ($EB6E) the load buffer subroutine is the same, but moved to 60266 ($EB6A). 

60292 to 60905 ($EB84 to $EDE9) all of the routines in this area are the same, but have entry 
points four bytes lower in ROM (i.e., 60288; $EB80). 
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60906 to 62014 ($EDEA to $F23E) these routines are the same and at the same locations in both 
versions. 

62015 ($F23F) test for RAM and special Cartridge has the same entry point, but has some changes 
to the routine. 

62038 ($F256) RAM check subroutine has changes and a new entry point, now at 62036 ($F254). 

62081 ($F281) the hardware initialization routines, have changes and a new entry point at 62071 
($F277) in the new ROMs. The changes continue to 62159 ($F2CF) where everything again 
becomes the same for both versions until the end of ROM at 65535 ($FFFF). 
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9 Appendix 5 - Color 

Color is a very important aspect in the Atari Computers; you may not fully appreciate it unless 
you've spent a long time working with Computers or monitors with monochrome displays. The Atari 
has sixteen colors available for display in eight different luminance (brightness) factors. These 
colors are stored in memory locations 704 to 712. The first four of these registers are used to 
determine the color of your players and missiles. The second five determine the color of the 
playfields, background, lines drawn and areas filled. 

The Atari has a default value for each of the five playfield registers that is assigned on powerup: 


Playfield 

Location 

Color 

Value 

0 

708 

Orange 

40 

1 

709 

Light green 

202 

2 

710 

Dark blue 

148 

3 

711 

Red 

70 

4 (BAK) 

712 

Black 

0 


The figure in the value category represents the number you would get if you PEEKed into that 
location. For discussion of the locations, refer to the Memory Map. 

To change these colors, you can use either a POKE Statement or the BASIC command 
SETCOLOR (abbreviated to SE). You should refer to 

the description in the earlier Memory Map text. SETCOLOR has three Parameters: the register to 
change (which always corresponds to one of the memory locations above); the hue (a number 
from zero to fifteen which corresponds to the available colors); and the luminance (an even number 
between zero and fourteen). The Atari will treat any odd number as if it were the next lowest even 
number where luminance is concerned. Your Statement might look like this: 

SETCOLOR 0,2,8 

This will produce the orange color in playfield zero. To change it to red, you would use: 

SETCOLOR 0,4,6 

Unless you are changing the background or border or you are changing a register which has 
already been used for drawing on the screen, you won't see any change from using SETCOLOR. 
The effect comes when you follow up with a COLOR command, telling the Atari which register to 
use for the DRAWTO or fill command. You can easily POKE the location with the proper color 
value by using this formula: 

COLOR = HUE * 16 + LUMINANCE 

So the orange in the above example would be obtained by: 

POKE 708,40 

and the red by: 

POKE 708,70 

These are the values listed in the chart above. It's quite simple to change them to your own colors 
using either method. Of course, you'll have to adjust your colors every time you change 
GRAPHICS modes or press RESET, since both restore the registers to their default values. What's 
more, the player/missile registers can only be changed using POKE; they have no corresponding 
SETCOLOR commands and are all preset to zero. The winter 81/82 edition of The Atari 
Connection, the house organ of Atari Inc., had a nice little chart in full color to display all of the 
colors available. The SETCOLOR number in the following list is the value you would place as the 
second number in the Statement right after the register number. 

SETCOLOR POKE 

Color number number 

Black 0 0 

Rust 1 16 
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Red-orange 
Dark orange 
Red 

Dark lavender 
Cobalt blue 
Ultramarine blue 
Medium blue 
Dark blue 
Blue-grey 
Olive green 
Medium green 
Dark green 
Orange-green 
Orange 


2 

32 

3 

48 

4 

64 

5 

80 

6 

96 

7 

112 

8 

128 

9 

144 

10 

166 

11 

176 

12 

192 

13 

208 

14 

224 

15 

240 


The next number in the SETCOLOR Statement would be the luminance. You would add the 
luminance value to the POKE number. 


When you want to use the DRAWTO or XIO 18 (FILL) commands, you must first specify what color 
register to use by the COLOR command. The confusing part for most people is that the number in 
the COLOR command doesn't correspond to the same number as the SETCOLOR register and, to 
make things worse, it's not always the same number in different GRAPHICS modes! Modes zero, 
one, and two are text modes; they print characters to the screen rather than graphics, so you don't 
use the COLOR command in these modes. In GR.O, you actually have only one color as chosen 
by SETCOLOR 2. The luminance is ignored in this command and is instead set with SETCOLOR 1 
-- where the color is ignored. You can use SETCOLOR to change the colors of the text and the 
background as below: 

GRAPHICS 0 
Character luminance 
Background 
Border (BAK) 

GRAPHICS 1 And 2 
Uppercase And numbers 
Lowercase characters 
Inverse uppercase 
Inverse lowercase 
Background, border 


SETCOLOR 

1 

2 

4 


SETCOLOR 

0 

1 

2 

3 

4 


Register 

709 

710 
712 


Register 

708 

709 

710 

711 

712 


When you want to draw or fill an area in modes three to eight, you must use the proper COLOR 
Statement for the SETCOLOR register: 


GRAPHICS 3, 5, 7 
Four color modes 
Graphics point Or 
fill area 

Background, border 


SETCOLOR 


COLOR Register 


0 1 708 

1 2 709 

2 3 710 

4 0 712 


GRAPHICS 4, 6 
Two color modes 
Graphics point 
Background, border 


SETCOLOR 


COLOR Register 


0 1 708 

4 0 712 


GRAPHICS 8 

One color, two luminances 
Graphics luminance 
Background color 
Border 


SETCOLOR 

1 

2 

4 


COLOR Register 

1 709 

0 710 

712 


It's awkward, but not difficult to use. You will have to refer to this chart or the chart on page 53 of 
your BASIC Reference Manual until you get the hang of it. Remember to precede any COLOR 
Statement with a SETCOLOR somewhere in your program and to precede a DRAW or XIO 18 with 
a COLOR or the Computer will use the previously designated register. 

The GTIA Chip confuses things somewhat: in GRAPHICS 10, register 704 Stores the background 
color while 712 is used as a normal color register. This means you must change it with a POKE 
rather than a SETCOLOR Statement. However, in the two other GTIA modes (GR.9 and GR. 11), 
you still use location 712, SETCOLOR 4, for the background; see the examples of GTIA modes at 
location 623. 
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With GRAPHICS 9, the COLOR command is used to set the luminance level to one of sixteen 
possible values; the value you use with the COLOR Statement is equal to the luminance used (so 
you can have COLOR 15, COLOR 10, etc. Actually you can use any value up to 255 with COLOR 
and not get an error message; see the demo program for GR.11 in location 623). SETCOLOR 4 
defines the background and graphics color. There is only one color in GR.9. In GRAPHICS 11, 
COLOR is used to define the color the same way it is used for luminance in GR.9, while the 
luminance of each color is the same value; you can have sixteen colors all of the same luminance. 
GRAPHICS 10 allows you to set the nine color registers to individual colors and luminances, but 
you must use POKE commands for the registers 704 to 707. 

For more information on the GTIA modes, see COMPUTEi, July to September 1982, and De Re 
Atari. There are many good programs for drawing your own pictures in various GRAPHICS modes; 
Micropainter from Datasoft is one of my favorites; then there's Drawpic from Artworx, The Graphics 
Machine from Santa Cruz, Graphic Master from Datasoft, Graphics Composer from Versaware 
and The Next Step from Online which is really a Utility for character creation and color set 
selection. COMPUTEi published an interesting program called "Supercube" over many issues in 
1980 and 1981. 
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10 Appendix 6 - Sound and Music 

Sound on the Atari can be quite sophisticated or quite simple, depending on your needs and 
programming abilities. Simple sounds may be input using the SOUND command; you enter the 
voice (zero to three), the pitch (zero to 255), the distortion (even numbers from zero to fourteen) 
and the volume (one to fifteen) in this manner: 

SOUND 0,121,10,8 

This will give you a pure tone middle C, moderate volume. The SOUND command is only one way 
to adjust your music or sound in the Atari. You can also POKE directly into the POKEY registers to 
effect changes. For example, you can increase the normal five octave ränge to nine by setting the 
proper bits in location 53768. This method reduces the number of voices to two or three, but does 
give you quite a ränge. You can use all sorts of tricks with filters, clock channels, and poly 
counters, as described in the POKEY locations. For the best description of sound control 
technique, see De Re Atari. Here are the pitch values for the major notes when used with a pure 
tone in the sound command: 


Note 


Octave 1 

2 

3 

4 


c 

14 

29 

60 

121 


B 

15 

31 

64 

128 

A# Or 

Bb 

16 

33 

68 

136 


A 

17 

35 

72 

144 

G# Or 

Ab 

18 

37 

76 

153 


G 

19 

40 

81 

162 

F# Or 

Gb 

21 

42 

85 

173 


F 

22 

45 

91 

182 


E 

23 

47 

96 

193 

D# Or 

Eb 

24 

50 

102 

204 


D 

26 

53 

108 

217 

C# Or 

Db 

27 

57 

114 

230 


You can see that the intervals between notes increase as the pitch decreases (the larger the 
number, the lower the pitch). Middle C is marked with Here's a simple routine to test pitch and 
distortion with one voice: 

5 Print CHR$(125): POKE 752,2 


10 

A = 

= 0: B = O: 

o 

II 

o 






20 

SOUND 0,A,B,C: 

: POSITION 0,0 






30 

Print "PITCH", 

. "DISTORTION", 

"VOLUME" 





35 

POSITION 0,2: 

Print A, B;" " 

, , C; " " 





40 

If 

STICK(0) = 

14 Then A = A + 

1: If A > 255 Then A 

= 0 

: GoTo 20 

50 

If 

STICK(0) = 

13 Then A = A - 

1: If A < 0 

Then 

A = 

255 

: GoTo 20 

60 

If 

STICK(0) = 

7 Then B = B + 

2: If B > 14 

Then 

B = 

0: 

GoTo 20 

70 

If 

STICK (0) = 

11 Then B = B - 

2: If B < 0 

Then 

B = 

14 : 

GoTo 20 

80 

If 

STRIG(O) = 

0 Then C = C + 

1: If C > 15 

Then 

C = 

0: 

GoTo 20 

90 

GoTo 20 








You move the stick up or down to change pitch, right or left to change the distortion level. Press the 
trigger to change the volume level. See Softside, #30 for a similar program using all four voices 
and Santa Cruz's Tricky Tutorial #6 (sound). You should also examine Atari's Music Composer 
cartridge; it is not only a fine program, but it also has excellent documentation on music, sound, 
and composition. There are two excellent programs from APX, Sound Editor and Insomnia, both of 
which allow you to create sounds to include in your programs (not tunes however). Insomnia is 
particularly interesting in that it creates sound which is played during the VBLANK intervals. 
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11 Appendix 7 - PM Graphics memory Map 

You have no doubt seen this little map in dozens of publications. It shows you where your PM 
graphics are located in memory. The problem is: what does it mean? I'll attempt to explain it below. 
First, the map: 


Double One Byte wide Single 

Line Line 

Resolution Resolution 

Offset Offset 

0 +-+ o 

I 

I unused 

area 

+384 |-1 +768 

I 0 | 1 | 2 | 3 
I missiles 

I 

+ 512 |-| +1024 

I 

I Player 0 

I 

+ 640 |-1 +1280 

I 

I Player 1 

I 

+768 I-1 +1536 

I 

I Player 2 

I 

+ 896 I-1 +1792 

I 

I Player 3 

I 

+ 1024 +-+ +2048 


No matter where in memory you reserve your PM graphics area, the location of the space used by 
the players and missiles will be offset the same number of bytes from the beginning of the reserved 
area. That's what the offset numbers represent: the number of bytes from the beginning of the PM 
area where that object's graphics begin. 

So, if you decide to reserve sixteen pages (4096 bytes) from the top of your memory (40960), your 
PM graphics will begin at 36864. Depending on which resolution you have chosen, the missile 
graphics area will begin either 384 or 768 bytes from that location: or at 37248 and 37632 
respectively. In double line resolution, you can define your objects up to 128 bytes in length; in 
single line they can be 256 bytes long. 

Even if your object is only eight or ten bytes in height, the boundaries for their placement are 
always the same relative offset from the top of PM graphics memory. 

This map is only eight bits -- one byte -- wide. You can see that all four missiles share the same 
width byte, each using two bits for resolution. If you combine the missiles to form a fifth player, you 
use this area exactly as you would the area for any other player. 

One means of moving your players vertically is to move the players within their reserved area 
rather than on the screen itself. In BASIC, this is considerably faster than having to move the 
player on the screen, but it's a slow process anyway. As far as the boundaries of the TV set are 
concerned, all players in both resolutions are mapped to the entire height of the screen. 

There are many good programs to create and edit PM graphics, mentioned earlier in the Memory 
Map text. PM graphics are one of the Atari's most powerful and least understood capabilities. I 
suggest you read up on them and try to master their use; they're not as difficult as they seem. 
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12 Appendix 8 - Display Lists 

A display list is a short program for the ANTIC Chip, telling it how to display data on the screen. 

This program includes such instructions as how many blank lines to place on the screen for top 
boundaries, where the screen display data is stored, what mode the line(s) to be displayed are in, 
whether or not there is an interrupt to execute and where to find the display list itself. 

There are nine pre-programmed display lists (ten with the GTIA) you use in BASIC, one for each 
GRAPHICS mode. You can examine the display lists for each mode by running the program at 
location 560. You can change these lists to suit your own needs without much effort. It is quite easy 
to design and implement your own display list once you know where it's located and what the 
proper instructions are. 

Certain techniques, such as horizontal and vertical fine scrolling, require that you modify the 
display list in order to properly display your screen data. Sometimes you want to be able to display 
data in more than one mode or mix graphics and text in the same screen. These are all done by 
modifying the display list. 

The smallest display list is for GRAPHICS 2, so l'll use it as an example. It consists of a mere 
twenty odd bytes, but the format is the same for every list; it's just the instructions that change. Use 
the program listed in the Memory Map to examine the list or use a simple two-liner such as: 

10 GRAPHICS 2: P = PEEK(560) + PEEK (561) * 256 
20 For N = 0 To 23: Print PEEK(P + N);" Next N 

When you RUN this example, you should get this: 

112 112 112 71 112 158 777777777 66 96 159 2 2 2 65 88 158 

Or something similar depending on your available memory. If you change the GR.2 to GR.2 + 16, 
you will get: 

112 112 112 71 112 158 77777777777 65 92 158 

The display list instruction set is discussed at location 560, but here's a chart to summarize it: 


Instruction 

BASIC 

Scan 

Pixels 

Bytes 

Comments 

Decimal 

Hex 

mode 

lines 

Line 

Line 

Blank instructions 

0 

0 

— 

1 

— 

— 

1 blank Line 

16 

10 

— 

2 

— 

— 

2 blank lines 

32 

20 

— 

3 

— 

— 

3 blank lines 

48 

30 

— 

4 

— 

— 

4 blank lines 

64 

40 

— 

5 

— 

— 

5 blank lines 

80 

50 

— 

6 

— 

— 

6 blank lines 

96 

60 

— 

7 

— 

— 

7 blank lines 

112 

70 


8 



8 blank lines 

Display instructions 

2 

2 

0 

8 

40 

40 

Text mode 0 

3 

3 

— 

10 

40 

40 

Text mode * 

4 

4 

— 

8 

40 

40 

Text mode * 

5 

5 

— 

16 

40 

40 

Text mode * 

6 

6 

1 

8 

20 

20 

Text mode 1 

7 

7 

2 

16 

20 

20 

Text mode 2 

8 

8 

3 

8 

40 

10 

graphics mode 3 

9 

9 

4 

4 

80 

10 

graphics mode 4 

10 

A 

5 

4 

80 

20 

graphics mode 5 

11 

B 

6 

2 

160 

20 

graphics mode 6 

12 

C 

— 

1 

160 

20 

graphics mode * 

13 

D 

7 

2 

160 

40 

graphics mode 7 

14 

E 

— 

1 

160 

40 

graphics mode * 

15 

F 

8 

1 

320 

40 

graphics mode 8 

Jump instructions 
(three bytes Long) 

1 

1 

— 

— 

— 

— 

jump To location 

65 

41 

— 

— 

— 

— 

jump And wait For 
VBLANK 


Modes marked with an asterisk (*) have no equivalent in BASIC. These are the instructions in the 
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display list. You can alter the display instructions by setting the bits for horizontal or vertical scroll, 
load memory scan (teils ANTIC where the next line(s) to be displayed are in memory and what 
mode to use for them) and enable a display list Interrupt. These are: 


Function 

add 

decimal 

hex 

bit 

Vertical scroll 

16 

10 

4 

Horizontal scroll 

32 

20 

5 

Load memory scan 

64 

40 

6 

Display list interrupt 

128 

80 

7 


The LMS instruction is a three-byte instruction; the second and third bytes are the LSB and MSB of 
the address where the line or screen data is to be displayed. You can add any or all of these 
modifications to the text or graphics mode instructions. You can only add the Interrupt modification 
to blank line or jump instructions. The two bytes that follow the jump instructions are the LSB and 
MSB of the address to which the ANTIC jumps to continue or repeat the list. So let's analyze the 
DL for GRAPHICS 2 that we printed above: 

112 These three instructions Print 

112 24 blank scan lines at the top 

112 of the screen 

71 GR.2 With LMS instruction added 

112 Address of the first Line of screen data 

158 158 * 256 + 112 = 40560 

7 Display the rest of the data In 

7 GR.2, so we have a total of 

7 ten GR.2 lines, Or 10 * 16 = 

7 160 scan lines used. 

7 

7 

7 

7 

7 

66 GR.O With LMS instruction added 

96 Address of the Text window at bottom 

159 159 * 256 + 96 = 40800 

2 GR.O For Text window, so we have 

2 a total of four lines 

2 

65 Jump And wait For vertical blank 

88 Address of display list itself 

158 158 * 256 + 88 = 40536 

(Return To the top of this list) 


Now examine the list for GR.2 + 16. You can see that it adds two 7's to replace the GR.O lines at 
the bottom of the screen. A little math shows us that the screen in both cases has a total of 192 
scan lines. That's an important number; if you want your screen to come out properly, you must 
insure that you get as close to this figure as possible; otherwise you'll end up with blank lines at the 
bottom of your screen, or worse -- in the display itself. 

You will find the value 112 in every Atari display list. The three of them are used to bring the display 
to a readable location on your set. Try replacing one or more of them with a zero to see what 
happens without them. The jump instructions are also used to skip across a 1K boundary, since 
the DL itself cannot cross a 1K boundary without such a jump. Also, DL data cannot cross a 4K 
boundary, so you must use an LMS instruction betöre Crossing one. 

The critical factor in designing your own display list is to make sure that the data and the scan lines 
match. This may require you to manipulate your data so that you have the proper number of bytes 
per line so that the display appears correctly on the screen. Here are the number of bits per pixel 


for each of the ANTIC modes: 

Mode 



Bits per 

decimal 

hex 

BASIC 

pixel 

2 

2 

0 

8 Text modes 

3 

3 

— 

8 

4 

4 

— 

8 

5 

5 

— 

8 

6 

6 

1 

8 

7 

7 

2 

8 

8 

8 

3 

2 graphics modes 

9 

9 

4 

1 
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10 

A 

5 

2 


11 

B 

6 

1 


12 

C 

— 

1 


13 

D 

7 

2 


14 

E 

— 

2 


15 

F 

8 

1 


You can have as many DL's as you wish, using the jump/vertical blank instruction at the end of the 
DL to teil ANTIC where your new DL is located. When placing your new DL (page six, unless used 
for other routines, is a good protected place to put it), do a POKE 559,0 to disable the DL fetch 
instructions, then POKE it with the proper value to turn it back on afterwards. Be inventive and 
create your own screens with varied lines of text and graphics. 

I suggest that you read De Re Atari and Your Atari 400/800 for more information. The latter has a 
few good examples of altered display lists and teils how to create them. Two DL Utilities are The 
Next Step from Online and Tricky Tutorial #1 from Santa Cruz. 
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13 Appendix 9 - Numerical conversions 

lf you use this map a lot, or use the Atari a lot for machine language routines, interrupts, graphics 
and the like, you know the need to translate between decimal and hexadecimal, even back and 
forth with binary, frequently. It is possible, although tedious, to do your translations by hand, using 
pencil and paper. The tables for doing so are below. It's not the best nor the fastest method 
available. I recommend you get the Texas Instruments TI Programmer calculator. It does most of 
this work for you, plus bit manipulation (unfortunately it does not öfter binary translation). It's an 
indispensable tool for programmers. 

There are other ways around buying the calculator: you can buy Monkey Wrench from Eastern 
House Software, which will do the hex - decimal translations for you quite nicely. Or you can buy 
any of the numerous disk or programming Utilities which include such translation routines, such as 
Disk Scan from Micro Media. However, those who wish to do the work themselves can use a 
simple translator program. One such example, modified from routines that appeared separately in 
COMPUTEI, November 1981 and March 1982, is: 

10 Dim HEX$ (16) ,DEC$ (23) , NUM$ (10) , W$ (4) , BIN$ (8) , BNY$ (8) , TRANS (8) 

15 DATA 128, 64,32,16, 8,4,2,1 

20 For N=1 To 8: Read B:TRANS(N)=B:NEXT N:POKE 201,14 
25 Print CHR$(125) 

30 HEX$ = "0123456789ABCDEF":DEC$" = @ABCDEFGHI!!!!!! !JKLMNO" 

40 ?:?"PRESS [OPTION] FOR HEXADECIMAL":?"{6 SPACES}[SELECT] FOR DECIMAL":?"{6 
SPACES}[START] FOR BINARY" 

42 ?"{6 SPACES}TRANSLATIONS":A=1:MAX=4096 
50 If PEEK(53279)=3 Then GoTo 100 
60 If PEEK(53279)=5 Then GoTo 200 
70 If PEEK(53279)=6 Then GoTo 300 
80 GoTo 50 

100 ? : ?"ENTER HEXADECIMAL NUMBER":"?"$0000 To $FFFF": INPUT NUM$:ACC=0:A=1:TRAP 100 
120 FOR NUM=1 TO LEN(NUM$):ACC=ACC*16+ASC(DEC$(ASC(NUM$(NUM))-47))-64:NEXT NUM:T=ACC 

125 IF AC0255 THEN BNY$ = "." : GOTO 170 

130 FOR N=7 TO 0 STEP-1 : BIN=2 A N 

135 IF INT(ACC/BIN)=1 THEN BNY$(A,A)="1":ACC=ACC-BIN:GOTO 150 
140 BNY$(A,A)="0" 

150 A=A+1:NEXT N 

170 ?:?"HEXADECIMAL","DECIMAL","BINARY" 

180 ? " ";NUM$,T,BNY$ 

190 ? :? : GOTO 40 

200 ? :? "ENTER DECIMAL NUMBER": ?"0 To 65535": INPUT NUM:T=NUM:Z=T:MAX=4096:TRAP 200 
205 IF NUM>65535 THEN GOTO 200 
208 IF NUM<1 THEN GOTO 200 

210 FOR N=1 TO 4:BYTE=INT(NUM/MAX):W$(N,N)=HEX$(BYTE+1,BYTE+1):NUM=NUM- 
MAX*BYTE : MAX=MAX/16 : NEXT N 

220 IF T>255 THEN BNY$ = ".": GOTO 270 

230 FOR N=7 TO 0 STEP -1:BIN=2~N 

235 IF INT(Z/BIN)=1 THEN BNY$(A,A)="1":Z=Z-BIN:GOTO 250 
240 BNY$(A,A)="0" 

250 A=A+1:NEXT N 

270 ?:?"DECIMAL","HEXADECIMAL","BINARY" 

2 80 ? " ";T,W$,BNY$ 

290 GOTO 40 

300 ? :? "Input Binary NUMBER":?"00000000 To 11111111":? :?"76543210 BITS":INPUT BIN$:TRAP 
300 

305 IF LEN(BIN$)<>8 THEN GOTO 300 

308 FOR B=1 TO 8:IF VAL(BIN$(B,B))>1THEN POP:GOTO 300 
310 NEXT B 

320 FOR B=1 TO 8:IF BIN$(B,B)="1" THEN TOT=TOT+TRANS(B) 

325 NEXT B: Q=TOT 

330 FOR L=1 TO 4:BYTE=INT(TOT/MAX):W$(L,L)=HEX$(BYTE+1,BYTE+1):TOT=TOT- 

MAX*BYTE : MAX=MAX/16 : NEXT L 

340 ?:?"Binary" , "HEXADECIMAL", "DECIMAL" 

350 ? " ";BIN$,W$,Q 
390 GOTO 40 

This program will translate any hexadecimal, decimal, and binary number to and from the others. 
There are some constraints in its use: it will not translate a binary number for any hex number 
larger than $FF or decimal number larger than 255. It will not translate any hex number larger than 
$FFFF or any decimal number larger than 65535. Since about 99% of your numeric manipulations 
will be within these ranges, you should have no problems. You can easily remove the translation 
routines from the program for use in your own utility. 
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For a quick way to translate any number in the ränge of zero to 65535 ($FFFF), use the table 
below. It's quite simple to use: to translate hex to decimal you take the number that appears in the 
column that corresponds to the value in the proper row and add the values together. The total is 
your decimal number. For example: 


$7AC1 = 28672 

fourth column. 

7 

2560 

third column. 

A 

192 

second column. 

c 

1 

first column. 

1 

31425 

decimal value 


To translate decimal into hex, you find the largest number less than the number you wish to 
translate and subtract it from your original number. The value in the row is the first hexadecimal 
value. You then do the same with the remainder until your result is zero. The values in the row are 
then concatenated together for a hexadecimal number. For example: 

31425 = 31425 

- 28672 largest number, column four. first hex number = 7 


2753 remainder, minus third column 
2560 second hex number = A 


193 remainder, minus second column 
192 third hex number = C 


1 remainder And fourth hex number 

Hexadecimal value = $7AC1 


Hex Column Hex 


number 

fourth 

third 

second 

first 

number 

1 

4096 

256 

16 

1 

1 

2 

8192 

512 

32 

2 

2 

3 

12288 

768 

48 

3 

3 

4 

16384 

1024 

64 

4 

4 

5 

20480 

1280 

80 

5 

5 

6 

24576 

1536 

96 

6 

6 

7 

28672 

1792 

112 

7 

7 

8 

32768 

2048 

128 

8 

8 

9 

36864 

2304 

144 

9 

9 

A 

40960 

2560 

160 

10 

A 

B 

45056 

2816 

176 

11 

B 

C 

49152 

3072 

192 

12 

C 

D 

53248 

3328 

208 

13 

D 

E 

57344 

3584 

224 

14 

E 

F 

61440 

3840 

240 

15 

F 


The next few pages are simply a listing of the decimal, hex,and binary values for the ränge of 
numbers between zero and 255. I have found this listing to be extremely useful when I couldn't 
enter a translator program or lay my hands on a calculator. Read the note in the introduction 
regarding the translation techniques for binary and hexadecimal. 


Decimal 

Hex 

Binary 

Decimal 

Hex 

Binary 

Decimal 

Hex 

Binary 

0 

0 

00000000 

34 

22 

00100010 

68 

44 

01000100 

1 

1 

00000001 

35 

23 

00100011 

69 

45 

01000101 

2 

2 

00000010 

36 

24 

00100100 

70 

46 

01000110 

3 

3 

00000011 

37 

25 

00100101 

71 

47 

01000111 

4 

4 

00000100 

38 

26 

00100110 

72 

48 

01001000 

5 

5 

00000101 

39 

27 

00100111 

73 

49 

01001001 

6 

6 

00000110 

40 

28 

00101000 

74 

4A 

01001010 

7 

7 

00000111 

41 

29 

00101001 

75 

4B 

01001011 

8 

8 

00001000 

42 

2A 

00101010 

76 

4C 

01001100 

9 

9 

00001001 

43 

2B 

00101011 

77 

4D 

01001101 

10 

A 

00001010 

44 

2C 

00101100 

78 

4E 

01001110 

11 

B 

00001011 

45 

2D 

00101101 

79 

4F 

01001111 

12 

C 

00001100 

46 

2E 

00101110 

80 

50 

01010000 

13 

D 

00001101 

47 

2F 

00101111 

81 

51 

01010001 

14 

E 

00001110 

48 

30 

00110000 

82 

52 

01010010 

15 

F 

00001111 

49 

31 

00110001 

83 

53 

01010011 

16 

10 

00010000 

50 

32 

00110010 

84 

54 

01010100 

17 

11 

00010001 

51 

33 

00110011 

85 

55 

01010101 

18 

12 

00010010 

52 

34 

00110100 

86 

56 

01010110 

19 

13 

00010011 

53 

35 

00110101 

87 

57 

01010111 

20 

14 

00010100 

54 

36 

00110110 

88 

58 

01011000 

21 

15 

00010101 

55 

37 

00110111 

89 

59 

01011001 
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22 

16 

00010110 

56 

38 

00111000 

90 

5A 

01011010 

23 

17 

00010111 

57 

39 

00111001 

91 

5B 

01011011 

24 

18 

00011000 

58 

3A 

00111010 

92 

5C 

01011100 

25 

19 

00011001 

59 

3B 

00111011 

93 

5D 

01011101 

26 

1A 

00011010 

60 

3C 

00111100 

94 

5E 

01011110 

27 

1B 

00011011 

61 

3D 

00111101 

95 

5F 

01011111 

28 

IC 

00011100 

62 

3E 

00111110 

96 

60 

01100000 

29 

ID 

00011101 

63 

3F 

00111111 

97 

61 

01100001 

30 

IE 

00011110 

64 

40 

01000000 

98 

62 

01100010 

31 

1F 

00011111 

65 

41 

01000001 

99 

63 

01100011 

32 

20 

00100000 

66 

42 

01000010 

100 

64 

01100100 

33 

21 

00100001 

67 

43 

01000011 

101 

65 

01100101 

102 

66 

01100110 

163 

A3 

10100011 

224 

EO 

11100000 

103 

67 

01100111 

164 

A4 

10100100 

225 

El 

11100001 

104 

68 

01101000 

165 

A5 

10100101 

226 

E2 

11100010 

105 

69 

01101001 

166 

A6 

10100110 

227 

E3 

11100011 

106 

6A 

01101010 

167 

Al 

10100111 

228 

E4 

11100100 

107 

6B 

01101011 

168 

A8 

10101000 

229 

E5 

11100101 

108 

6C 

01101100 

169 

A9 

10101001 

230 

E6 

11100110 

109 

6D 

01101101 

170 

AA 

10101010 

231 

E7 

11100111 

110 

6E 

01101110 

171 

AB 

10101011 

232 

E8 

11101000 

111 

6F 

01101111 

172 

AC 

10101100 

233 

E9 

11101001 

112 

70 

01110000 

173 

AD 

10101101 

234 

EA 

11101010 

113 

71 

01110001 

174 

AE 

10101110 

235 

EB 

11101011 

114 

72 

01110010 

175 

AF 

10101111 

236 

EC 

11101100 

115 

73 

01110011 

176 

BO 

10110000 

237 

ED 

11101101 

116 

74 

01110100 

177 

Bl 

10110001 

238 

EE 

11101110 

117 

75 

01110101 

178 

B2 

10110010 

239 

EF 

11101111 

118 

76 

01110110 

179 

B3 

10110011 

240 

FO 

11110000 

119 

77 

01110111 

180 

B4 

10110100 

241 

Fl 

11110001 

120 

78 

01111000 

181 

B5 

10110101 

242 

F2 

11110010 

121 

79 

01111001 

182 

B6 

10110110 

243 

F3 

11110011 

122 

7A 

01111010 

183 

B7 

10110111 

244 

F4 

11110100 

123 

7B 

01111011 

184 

B8 

10111000 

245 

F5 

11110101 

124 

IC 

01111100 

185 

B9 

10111001 

246 

F6 

11110110 

125 

7D 

01111101 

186 

BA 

10111010 

247 

F7 

11110111 

126 

7E 

01111110 

187 

BB 

10111011 

248 

F8 

11111000 

127 

7F 

01111111 

188 

BC 

10111100 

249 

F9 

11111001 

128 

80 

10000000 

189 

BD 

10111101 

250 

FA 

11111010 

129 

81 

10000001 

190 

BE 

10111110 

251 

FB 

11111011 

130 

82 

10000010 

191 

BF 

10111111 

252 

FC 

11111100 

131 

83 

10000011 

192 

CO 

11000000 

253 

FD 

11111101 

132 

84 

10000100 

193 

CI 

11000001 

254 

FE 

11111110 

133 

85 

10000101 

194 

C2 

11000010 

255 

FF 

11111111 

134 

86 

10000110 

195 

C3 

11000011 




135 

87 

10000111 

196 

C4 

11000100 




136 

88 

10001000 

197 

C5 

11000101 




137 

89 

10001001 

198 

C6 

11000110 




138 

8A 

10001010 

199 

C7 

11000111 




139 

8B 

10001011 

200 

C8 

11001000 




140 

8C 

10001100 

201 

C9 

11001001 




141 

8D 

10001101 

202 

CA 

11001010 




142 

8E 

10001110 

203 

CB 

11001011 




143 

8F 

10001111 

204 

CC 

11001100 




144 

90 

10010000 

205 

CD 

11001101 




145 

91 

10010001 

206 

CE 

11001110 




146 

92 

10010010 

207 

CF 

11001111 




147 

93 

10010011 

208 

DO 

11010000 




148 

94 

10010100 

209 

Dl 

11010001 




149 

95 

10010101 

210 

D2 

11010010 




150 

96 

10010110 

211 

D3 

11010011 




151 

97 

10010111 

212 

D4 

11010100 




152 

98 

10011000 

213 

D5 

11010101 




153 

99 

10011001 

214 

D6 

11010110 




154 

9A 

10011010 

215 

D7 

11010111 




155 

9B 

10011011 

216 

D8 

11011000 




156 

9C 

10011100 

217 

D9 

11011001 




157 

9D 

10011101 

218 

DA 

11011010 




158 

9E 

10011110 

219 

DB 

11011011 




159 

9F 

10011111 

220 

DC 

11011100 




160 

A0 

10100000 

221 

DD 

11011101 




161 

Al 

10100001 

222 

DE 

11011110 




162 

A2 

10100010 

223 

DF 

11011111 
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14 Appendix 10 - Character code values 

ATASCII And Internal Character Code Values 


Character 

ATASCII 

Internal 

Character 

ATASCII 

Internal 

space 

32 

0 

Z 

90 

58 

! 

33 

1 

[ 

91 

59 

" 

34 

2 

\ 

92 

60 

# 

35 

3 

] 

93 

61 

$ 

36 

4 

A 

94 

62 

% 

37 

5 


95 

63 

& 

38 

6 

CTRL-, 

0 

64 

' 

39 

7 

CTRL-A 

1 

65 

( 

40 

8 

CTRL-B 

2 

66 

) 

41 

9 

CTRL-C 

3 

67 

k 

42 

10 

CTRL-D 

4 

68 

+ 

43 

11 

CTRL-E 

5 

69 

, 

44 

12 

CTRL-F 

6 

70 

- 

45 

13 

CTRL-G 

7 

71 


46 

14 

CTRL-H 

8 

72 

/ 

47 

15 

CTRL-I 

9 

73 

0 

48 

16 

CTRL-J 

10 

74 

1 

49 

17 

CTRL-K 

11 

75 

2 

50 

18 

CTRL-L 

12 

76 

3 

51 

19 

CTRL-M 

13 

77 

4 

52 

20 

CTRL-N 

14 

78 

5 

53 

21 

CTRL-0 

15 

79 

6 

54 

22 

CTRL-P 

16 

80 

7 

55 

23 

CTRL-Q 

17 

81 

8 

56 

24 

CTRL-R 

18 

82 

9 

57 

25 

CTRL-S 

19 

83 


58 

26 

CTRL-T 

20 

84 

; 

59 

27 

CTRL-U 

21 

85 

< 

60 

28 

CTRL-V 

22 

86 

= 

61 

29 

CTRL-W 

23 

87 

> 

62 

30 

CTRL-X 

24 

88 

7 

63 

31 

CTRL-Y 

25 

89 

@ 

64 

32 

CTRL-Z 

26 

90 

A 

65 

33 

ESCAPE 

27 

91 

B 

66 

34 

UP ARROW 

28 

92 

C 

67 

35 

DOWN 



D 

68 

36 

ARROW 

29 

93 

E 

69 

37 

LEFT ARROW 

30 

94 

F 

70 

38 

RIGHT ARROW 

31 

95 

G 

71 

39 

CTRL-. 

96 

96 

H 

72 

40 

a 

97 

97 

I 

73 

41 

b 

98 

98 

J 

74 

42 

c 

99 

99 

K 

75 

43 

d 

100 

100 

L 

76 

44 

e 

101 

101 

M 

77 

45 

f 

102 

102 

N 

78 

46 

g 

103 

103 

0 

79 

47 

h 

104 

104 

P 

80 

48 

i 

105 

105 

Q 

81 

49 

j 

106 

106 

R 

82 

50 

k 

107 

107 

S 

83 

51 

1 

108 

108 

T 

84 

52 

m 

109 

109 

U 

85 

53 

n 

110 

110 

V 

86 

54 

o 

111 

111 

W 

87 

55 

P 

112 

112 

X 

88 

56 

q 

113 

113 

Y 

89 

57 

r 

114 

114 

Character 

ATASCII 

Internal 




s 

115 

115 




t 

116 

116 




u 

117 

117 




V 

118 

118 




w 

119 

119 




X 

120 

120 




y 

121 

121 




z 

122 

122 




CTRL-; 

123 

123 




3 

124 

124 




CLEAR 

125 

125 




DELETE 

126 

126 




TAB 

127 

127 
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j 


174 


Inverse characters are the same as the characters above with 128 added to the values listed. This 
is done by setting the seventh bit (adding 128). There are other codes used which are outside this 
ränge: 

ATASCII Function 


155 

156 

157 

158 

159 

253 

254 

255 


End Of Line (Return) 
Delete line 
Insert line 
CTRL-Tab 
Shift-Tab 
CTRL-2 (buzzer) 
Delete character 
Insert character 


See your Atari Reference Manual, pages CI to C3 and Fl. In order to print the arrow keys, clear, 
insert, delete, buzzer, escape key, or any of the codes listed above to the screen, you must press 
the ESC key betöre entering the keyboard character(s). 

Not all of these codes can be sent to the printer. ATASCII codes zero to 31 print blank or they may 
send control codes to your printer, depending on the make. 96 will print a backwards apostrophe 
instead of a diamond, 123 will print a left bracket instead of a spade, 125 will print a right bracket 
instead of a clear, 126 will print a tildis instead of a backspace and 127 will print a blank instead of 
tab. 

There is a third set of codes used by the Atari keyboard handler. These values are listed in the OS 
User's Manual. 
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15 Appendix 11 - Addenda and Errata 

Addenda And Errata To The First Edition 

The material which follows is arranged by decimal address, hex, then name, followed by the 
description, In some locations, all that's added is a particularly good reference article or book which 
further elucidates the use of that memory. 

Lower memory locations used by BASIC and page six may be used for other purposes by other 
languages--the ABC and Datasoft BASIC Compilers and MAC/65, for example, use many locations 
to perform different tasks from those performed in the same space by BASIC. Read the language's 
or compiler's memory map betöre using these locations in order to avoid a conflict. The same may 
be true of the more recent custom DOS programs which have been released since the first edition 
of the book. 

9 9 BOOT 

A value of 3 means both cassette and disk boot were successful. 

You can trap the RESET button by POKE 9,3 followed by a POKE 
2 and 3 (CASINI) with the address (LSB/MSB) of your machine 
language routine to trap RESET (also störe 3 into location 9 
within the routine) and an RTS at the end. 

12,13 C,D DOSINI 

To trap RESET into rerunning your machine language program, 
load the initialization address of the program here. You can 
also do it through CASINI; see above. 

18,19,20 12,13,14 RTCLOK 

The number referred to in the second paragraph should be 256 
cubed minus 1 (256 * 256 * 256 - 1). Also, to get the number of 
seconds from the jiffy count, divide by 59.92334 (the actual VBI 
time interval), not 60. See articles by Stephen Levy in COM¬ 
PUTERS Third Book of Atari and by Bob Cockcroft in ROM 
(December 1984 and February 1985) for articles on Atari timers. 

29 ID PBPNT 

The pointer to the current byte or character to be sent to the 
Printer. 

33 21 ICDNOZ 

The current device number. 

59 3B CHKSNT 

Zero means not sent. 

66 42 CRITIC 

POKE 66,1 to disable the update between shadow and hard- 
ware registers; then you can POKE directly into the hardware 
registers themselves. You can disable VBLANK at 54286 ($D40E) 
as well. 

67-73 43-49 FMZSPG 

Reinitialized by FMS each time it takes control. 

82,83 52,53 LMARGN and RMARGN 

Both have a ränge of 0 to 39. 

85,86 55,56 COLCRS 

Has a ränge of 0 to 319. 

87 57 DINDEX 
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To turn off the Cursor when drawing in a text mode, POKE 752,1, 
followed by a PRINT Statement, To get different colors, add a 
COLOR Statement betöre the PLOT routine, The character will 
be the ASCII equivalent of the number which follows COLOR. 

88,89 58,59 SAVMSC 

The program to save the graphics screen doesn't work, To save 
your graphics screen, create a string to hold a machine lan- 
guage call routine: 

1 DATA 104,104, 104,170,76, 66,228 

2 REM PLA, PLA, PLA, TAX, JMP $E456 

5 For N=1 To 7: Read Byte :ML$(N,N)=CHR$ (Byte ): Next N 

Now OPEN a channel for writing to disk (OPEN #4.8,0, 
"D:filename.ext"). Find RAMTOP (FINISH = PEEK(106) * 256 - 
160), subtracting 160 bytes for any text window screen. Find the 
address of the display list (DLIST = PEEK(560) + 256 * 

PEEK(561): START = PEEK(DLIST + 4) + 256 * PEEK(DLIST + 5): 
HIGH = INT(START/256): LOW = START - 256 * HIGH), and 
POKE it into the proper location in the IOCB (POKE 900,LOW: 

POKE 901,HIGH). 

Next, figure the screen length (SIZE = (FINISH - START) + 1: 

SZHI = INT(SIZE/256): SZLO = SIZE - 256 * Bl), and POKE itinto 
the IOCB (POKE 904,SZLO: POKE 905,SZHI). POKE the binary SAVE 
command into the IOCB (POKE 898,11). Call the CIO with the 
USR command (X=USR(ADR(ML$),4 * 16)). Finally, save your 
current graphics mode (MODE = PEEK(87): PUT #4,MODE) and 
color registers (FOR N = 708 TO 712; PUT #4,PEEK(N): NEXT N) 
and CLOSE #4. 

To recall the screen, use the same USR routine and the above 
PEEKs and POKEs, but POKE 898,7 rather than 11. This was de- 
rived from a larger program by Fred Pinto in the March 1984 is- 
sue of Antic. An article by Steve Kaufman in COMPUTEI, 

November 1983, has a fast and dirty method which works just 
as well (save and load), but doesn't save the color registers. 

Creative Computing, November 1983, also had a similar ex- 
ample in "Outpost Atari." 

106 6A RAMTOP 

See K.W. Harm’s article on the "RAMTOP Dragon" in COM¬ 
PUTERS Second Book of Atari Graphics to see how to protect 
high memory; another article in the same book, by Jim Clark, 
describes how to protect low memory. 

118 76 DELTAR 

This is the change of vertical Position when drawing a sloped 
line. 

121 79 ROWINC 

Direction of line draw: 0 is down, 255 is up. 

122 7A COLINC 

Direction of draw: 0 is right, 255 is left. 

126,127 7E,7F COUNTR 

Iterations or steps required to draw a line. 

132,133 84,85 VNTD 

COMPUTEI, October 1983, has an article by E.H. Foerster on 
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how to reserve a portion of RAM above VNTD-within a BASIC 
program-which will also be saved intact when you save the 
program. 

138,139 8A,8B STMCUR 

Another way to lock up the System if something is done--say, 

BREAK pressed--is by Z=USR(0). 

146 92 MEOLFLG 

BASIC's modified EOL flag register. The Atari BASIC Sourcebook 
lists all the RAM locations used by BASIC (pages 144-147). 

147 93 
Spare. 

149,150 95,96 POKADR 

Address (LSB/MSB) of last POKE location, If no POKE command 
was given, it is the address of the last OPERATOR token (often 
155 forEOL). 

182 B6 DATAD 

The data element being read. Registers the number of the ele- 
ment in that line, say the tenth item in a DATA Statement. 

183,184 B7,B8 DATALN 

DATA Statement line number; the BASIC line number of a DATA 
Statement being currently read. The RESTORE Statement sets the 
locations (and 182, above) back to zero. You can do the same 
with a POKE. Here's a program which demonstrates these loca¬ 
tions from Steve Rockower, Atari SIG. CompuServe. 

10 REM DEMONSTRATES 182- 184($B6-$B8) As SUBSTITUTES For RESTORE 
20 REM 182 ($B6) POINTS To ITEM OF A Line TO BE Read Next 
30 REM DATA STATEMENTS HAVE ELEMENT NAME SEQUENTIALLV And 
40 REM NUMBER In CURRENT Line 
50 Dim C$(2),A$(20):C$=CHR$(125) 

100 DATA ONE—1, TWO-2, THREE-3, FOUR-4, 0 
110 DATA FIVE-1, SIX-2, SEVEN-3, EIGHT-4, 0 
120 DATA <9-l>,<10-2>,<ll-3>,<12-4>,1 
150 Print C$:RESTORE 100 
160 Read A$:If A$=”0" Then 200 

170 If PEEK(182)=1 Then Print :Print "READING LINE: " ; PEEK(183)+256*PEEK(184) 
180 If A$ ="1" Then 300 

190 Print "#";PEEK(182);" Ä$;"{3 SPACES GoTo 160 

200 Print :GoTo 160 
300 Print :Print 

310 TRAP 400: Print "WHICH DATA LINE (1,2, OR 3)";:Input DATALINE 
320 Print "WHICH ITEM (1,2,3, OR 4)";:InputITEM 
330 LET DATALINE=90+10*DATALINE 

340 POKE 184, INT(DATALINE/256) :POKE 183,DATALINE-INT(DATALINE/256) 

350 POKE 182,ITEM-1 
360 Read A$:Print A$ 

370 GoTo 310 
400 End 

190 BE SAVCUR 

Saves current line address. 

192 C0 IOCMD 

I/O command. 

193 CI IODVC 

I/O device. 

194 C2 PROMPT 

Prompt character. 
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200 C8 COLOR 

Stores the COLOR number used in a PLOT or DRAWTO Statement. 
The Statement COLOR x can be replaced by POKE 200,x. Same 
as location 763 ($2FB), but BASIC takes the value from 200 and 
loads it into 763 betöre drawing or filling. From Judson Pewther, 

New York. 

202 CA LOADFLG 

Load in progress flag. 

210,211 D2,D3 

BASIC floating-point work area. $D2 is used for the variable 
type, $D3 for the variable number and length of the FP 
mantissa. 

212,213 D4,D5 FR0 

Used by the USR command to return a two-byte number to 
BASIC. If you störe nothing here, then the equation 
"l=USR(address, variables)" returns the address of the USR sub- 
routine. Otherwise, you can störe an integer (ränge 0-65535) 
here which becomes the value of the USR function, From Judson 
Pewther. New York. 

522,523 20A,20B VSERIN 

Serial input ready vector. 

524,525 20C,20D VSEROR 

Serial output ready vector. 

528-533 210-215 POKEY timers 

In "From Here to Atari" in Micro, June and December 1983, 

Paul Swanson explained how POKEY timers work-properly. 

The manuals have an inaccurate description that causes your 
System to lock up. The method below is taken from those issues. 

This is described for channel 1; it can be used in channels 2 
and 4 (not 3) by selecting the appropriate control and interrupt 
vectors. First, POKE AUDCTL (53768; $D208) with a frequency 
value (0 = 64 kilohertz, 1=15 kilohertz, 96 = 1.79 megahertz). 

(You can actually change frequency between interrupts if you 
wish.) Next, set the channel control register (53761; $D201). Enter 
your interrupt routine and POKE its address into 528, 529 ($210, 
$ 211 ). 

After this is done, POKE 53769,0 ($D209). Now enable the inter¬ 
rupt: POKE 16 with PEEK(16) plus the number of the interrupt 
you're using (1 = timer 1 interrupt, 2 = timer 2, 4 = timer 4 - 
there's no timer 31). POKE the same value into 53774. Your inter¬ 
rupt routine will begin; it will generate an interrupt when the 
timer counts down to zero. The timer is reloaded with the orig¬ 
inal value you POKEd there, and the process begins all over 
again. 

There are several problems to watch for: First, the OS pushes 
the A register onto the stack betöre jumping through the vector 
address. If you need the X and Y registers, push them on as 
well. Betöre you return from the interrupt, pull the X and Y back 
off, PLA, and clear the interrupt with CLI. 

If you don't need the screen display, POKE 559,0 to turn it off; 

DMA steals clock cycles from the timer, This means you'll have 
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to make any commands which deal with shadow registers (like 
SETCOLOR and GRAPHICS) first. DMA also turns off the keyboard 
repeat and realtime clock. Disable the keyboard to gain a bit 
more time if necessary. 

Refer to Micro and ROM, December 1984, for more Information 
about POKEY timers. 

555 22B SRTIMR 

Each time you read this location, you get a different number. 

That's because it's counting down from when a key is de- 
pressed to time the delay betöre repeating the key. 

558 22E CDTMF5 

Set when location 544,545 ($220,$221) counts down to zero. From 
Joe Gelman, Atari SIG, CompuServe. 

570 23A CDEVIC 

The current SIO bus ID (device) number. 

632 278 STICKO 

The pins on the joystick port are mapped as follows: 


\ / 

\ 1 2 3 4 5 / 

\ / 

\ 6 7 8 9 / 

\ _ / 

1 Stick forward 

2 Stick back 

3 Stick left 

4 Stick right (1-4 are four bits of the PIA port) 

5 Potentiometer (paddle) B input (analog pin 1) 

6 Trigger 

7 +5 volts (recommended load of one TTL at 50 ma) 

8 GND 

9 Potentiometer A input (analog pin 2) 

See Creative Computing, August 1983, for an example of using 
the Atari ports for external control. 

743,744 2E7,2E8 MEMLO 

It's quite handy to reserve a block of memory below your 
BASIC program and use it to störe variables which can be 
passed back and forth between programs with PEEKs and 
POKEs, Here's another routine which will reserve low memory 
for you: 

5 Print FRE(O) 

6 REM PROGRAM IS WIPED OUT AFTER RUNNING: BE SURE To SAVE IT FIRST 

7 REM Print FRE(O) AFTER RUNNING To Compare VALUES 

10 REM REPLACE BYTES VARIABLE With NUMBER OF BYTES To PROTECT 
20 MEMLO=BYTES+PEEK(743)+PEEK(744)*256 
30 HIBYTE=INT(MEMLO/256) 

40 LOBYTE=MEMLO-(INT(MEMLO/256)*256) 

50 POKE 743, LOBYTE : POKE 744, MBYTE 

60 POKE 128,LOBYTE:POKE 129, HIBYTE:REM BASIC LOMEM POINTER 
70 POKE 8,0:REM RESET FLAG 

80 X=USR(40960):REM JUMP To BASIC COLDSTART 

752 2F0 CRSINH 

Watch out for conflict with 755 when setting this location (and 
vice versa). 
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755 2F3 CHACT 

See COMPUTERS Third Book of Atari for an article by Frank 
Jones on creating blinking characters. 

763 2FB ATACHFt 

Not the color times 16 plus luminance; this is the number of the 
latest COLOR Statement, taken from location 200 ($C8). If you 
POKE the number here, BASIC will take the number stored in 
location 200 and dump it, changing your value (not so in ma¬ 
chine language, however). From Karl Wiegers. Rochester, and 
Judson Pewther, New York. 

764 2FC CH 

In COMPUTEI's Third Book of Atari, Orson Scott Card explained 
the keyboard and how to read it using the CH register. 

The values listed as "internal code" in Appendix 10 are not the 
same as those produced at 764. The internal code is the order 
the characters are stored in the character set. The keycode re- 
flected by 764 is the hardware code, which is altogether dif¬ 
ferent for no reason l've been able to ascertain. 

768-779 300-30B Page three device 

information 

Here are some brief examples showing how to use these loca- 
tions with the disk drive (it already has a handler in place, and 
we don't have to write a new one). The CIO call routine can be 
used in all your disk I/O routines based around these locations. 

To check if a sector has data in it: 

5 Dim SEC$(128),CHK$(128) 

10 DATA 104,32, 83, 228, 96 

15 SEC$(1)=CHR$(0):SEC$(128)=SEC$:SEC$(2)=SEC$:CHK$(1)=CHR$(0):CHK$(128) 
=CHK$ : CHK$ (2) =CHK$ 

16 REM SETS UP ARRAY SPACE And FILLS IT 

17 REM CHK$ IS FULL OF BLANK SPACES - CONTENTS OF UNUSED SECTORS 
20 For N=1536 To 1540 :Read X:POKE N,X:Next N 

25 REM THIS POKES THE CIO Call UP ROUTINE INTO PAGE SIX 
30 POKE 769,1:POKE 770,82 

35 REM THIS POKES THE DRIVE NUMBER (1) And Read Function (82) 

40 Print "ENTER A SECTOR NUMBER TO CHECK”:INPUT SNUM 

45 If SNUM<0 Or SNUM>720 Then 40:REM VALIDITY CHECK On NUMBERS 

50 POKE 778,SNUM-(INT(SNUM/256)*256):POKE 779,INT(SNUM/256) 

51 REM POKES LSB, MSB OF SECTOR INTO 778, 779 

55 BUFFER=ADR(SEC$) :BUFFL=BUFFER-(INT(BUFFER/256)*256) :BUFFH=INT(BUFFER/256) 

56 POKE 772,BUFFL:POKE 773,BUFFH 

57 REM POKE ADDRESS OF SEC$ INTO BUFFER ADDRESS 
60 Z=USR(1536):REM Call UP CIO ROUTINE 

70 If SEC$=CHK$ Then Print "NO DATA IN SECTOR": GoTo 40 
80 Print "SECTOR HAS DATA": GoTo 40 

Another method to check for sector use is to see if byte 125 
($7D) shows a sector has data in it; if not zero, it is being used (it 
records the number of bytes used in a sector). You can examine 
the sector contents by adding PRINT SEC$ after the read. 

PRINT PEEK(771) after reading a sector will display the Status; 1 
means good, any other number means bad. Check for bad sec- 
tors by PEEKing here after any sector read. 

The above routine with a few modifications will print a list of all 
the sectors on a disk with data in them (best directed to your 
Printer, but I use the screen display in the example below). This 
is a slow and inelegant routine, but you can easily rework it for 
your own use. 
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5 Dim SEC$(128),CHK$(128),CNT(720) 

10 DATA 104,32, 83, 228, 96 

15 

SEC$(1)=CHR$(0):SEC$(128)=SEC$:SEC$(2)=SEC$:CHK$(1)=CHR$(0):CHK$(128)=CHK$:CHK$(2)=CHK$ 

16 REM SETS UP ARRAY SPACE And FILLS IT 

17 REM CHK$ IS FULL OF BLANK SPACES - CONTENTS OF UNUSED SECTORS 

18 For L00P=0 To 720:CNT (Loop) =0:REM Empty ARRAY 
20 For N=1536 To 1540 :Read X:POKE N,X:Next N 

25 REM THIS 

30 POKE 769,1:POKE 770,82 

35 TRAP 100 

40 For SNUM=1 To 720 

50 POKE 778,SNUM-(INT(SNUM/256)*256):POKE 779,INT(SNUM/256) 

51 REM POKES LSB, MSB OF SECTOR INTO 778, 779 

55 BUFFER=ADR(SEC$) :BUFFL=BUFFER-(INT(BUFFER/256)*256) :BUFFH=INT(BUFFER/256) 

56 POKE 772,BUFFL:POKE 773,BUFFH 
60 Z=USR(1536) 

70 If SEC$=CHK$ Then CNT(SNUM)=0: Next SNUM:GoTo 100 
80 CNT(SNUM)=SNUM: Next SNUM 
100 For Loop=l To 720 

110 If CNT (Loop) =0 Then Next Loop : GoTo 150 
120 Print CNT(Loop);" ";:Next Loop 
150 End 

To copy one sector to another, use the routine below. Add a 
loop routine to copy more than one at a time. This routine 
copies all 128 bytes, including the three "record" bytes. 

1 Dim SEC$(128,Z$(1) 

2 REM SPACE For SECTOR DATA 
5 DATA 104,32,83,228, 96 

10 For N=1536 To 1540:Read X:POKE N,X:Next N 
15 REM POKE CIO Call DATA INTO PAGE SIX 
20 Print "WHAT SECTOR TO COPY FROM?" 

25 Input START: If START<0 Or START>720 Then 25 
30 Print "WHAT SECTOR TO COPY TO?" 

35 Input FINISH: If FINISH<0 Or FINISH>720 OR FINISH=START Then 35 
40 POKE 770, 82:REM Read COMMAND 

45 POKE 778,START-(INT(START/256)*256) :POKE 779, INT(START/256) 

46 REM POKE LSB/MSB OF SECTOR To COPY 

50 LOC=ADR(SEC$):POKE 772,LOC-(INT(LOC/256)*256):POKE 773,INT(LOC/256) 

55 REM POKE LSB/MSB OF ADDRESS OF DATA (SEC$) INTO BUFFER ADDRESS 
60 A=USR(1536):REM Read SECTOR INTO SEC$ 

70 Print "PRESS RETURN TO WRITE SECTOR": INPUT Z$ 

80 POKE 770, 87:REM Write COMMAND 

85 POKE 778,FINISH-(INT(FINISH/256)*256) :POKE 779,INT(FINISH/256) 

86 REM POKE LSB/MSB OF SECTOR To COPY To 
90 A=USR(1536):REM Write IT 

100 GoTo 20 

See Antic magazine, December 1984, for more information about 
device control. Several magazines have published BASIC pro- 
grams to edit your disk by sectors, There are also good public 
domain programs of this sort on the Atari SIG on CompuServe. 

769 301 DUNIT 

Current number of device being used. 

771 303 DSTATS 

Status = 1 means good. 

784,785 310,311 TIMER2 

Final baud rate timer value. 

832-959 340-3BF lOCBs 


IOCB Address Chart 


Label 

IOCBO 

IOCB1 

IOCB2 

IOCB3 

IOCB4 

IOCB5 

IOCB6 

IOCB7 

Use 

ICHID 

832 

848 

864 

880 

896 

912 

928 

944 

index 

ICDNO 

833 

849 

865 

881 

897 

913 

929 

945 

dev # 

ICCOM 

834 

850 

866 

882 

898 

914 

930 

94 6 

command 

ICSTA 

835 

851 

867 

883 

899 

915 

931 

947 

Status 
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ICBAL/H 

836 

852 

868 

884 

900 

916 

932 

948 

buffer 

ICPTL/H 

838 

854 

870 

886 

902 

918 

934 

950 

put buf 

ICBLL/H 

840 

856 

872 

888 

904 

920 

936 

952 

buf Len 

ICAX1 

842 

858 

874 

890 

906 

922 

938 

954 

task # 

ICAX2 

843 

859 

875 

891 

907 

923 

939 

955 

aux2 

ICAX3 

844 

860 

876 

892 

908 

924 

940 

956 

sectorl 

ICAX4 

845 

861 

877 

893 

909 

925 

941 

957 

sectorh 

ICAX5 

846 

862 

878 

894 

910 

926 

942 

958 

Byte # 

ICAX6 

847 

863 

879 

895 

911 

927 

943 

959 

aux6 


1152-1405 480-57D STACK 

A 254-byte BASIC syntax checking stack; $480 is a BASIC input 
index, $481 an output index, $482 a program counter. 

1536 600 Page Six 

Any I/O greater than 128 bytes in BASIC will wipe out the bot- 
tom 128 bytes in page six. This is because the I/O butter Starts at 

1408 ($580), a mere 128 bytes below page six. 

1792 700 DOS 

Here's a quick routine to read a disk directory in BASIC: 

5 Dim R$(20) 

10 Open #4,6,0,"D:*. 

20 Input #4, R$ : TRAP 60 
30 Print R$ 

40 If R$(10,16)="SECTORS" Then 100 
50 GoTo 20 
60 Print R$ 

100 Close #4 

For a quick method of inputting text into a tile, choose Copy 
from the DOS menu and answer E:,D:filename. You can now 
type directly to a disk tile. End each line with RETURN and end 
the tile with CTRL-3. You can change with backspace, but each 
line must have a RETURN in order to be accepted. 

Another Digression: Disk Sectors 

In a normal disk sector there are 128 bytes, 0 through 127. The 
last three bytes are reserved by DOS for: 

Byte Use 

125 Leftmost six bits: tile number (0-63, $3F); 
rightmost two bits: next sector number (high two 
bits) 

126 Next sector number (low eight bits of the sector 
number) 

127 Number of bytes used in this sector (0-125, $7D) 

The next sector to read is in a ten-bit number: eight bits from 
byte 126 ($7E) and the two low bits of 125 ($7D). This means the 
six leftmost bits remaining in byte 125 can be used only to count 
up to 63 (which with zero makes for 64 filenames in one direc¬ 
tory). This is true when reading linked files, such as BASIC pro- 
grams or text files; auto-boot programs are usually sequential 
and are not linked in this manner (nor are the first four boot 
sectors, the VTOC, or directory sectors). When the next sector 
number is zero, there are no more sectors to read. 

A binary file always begins with 255 ($FF) twice, then four 
bytes: the LSB and MSB ot the Start and end addresses, respec- 
tively, of the data to follow (that is, if they were 00 A0 00 B0, it 
would Start at $A000 and end at $B000). When a number of 
bytes are loaded to fulfill the load vector, DOS assumes the next 
four bytes are more start/end address vectors and will continue 
to input the following data at the new address unless an EOF 


Converted and layouted 2006 by Andreas Bertelmann for ABBUC 







Appendix 11 - Addenda and Errata 184 


(End Of File) is reached. Control is passed back to DOS at the 
end of a load unless you put a new run address into 736,737 
($2E0, $2E1). You can append a code like EO 02 El 02 00 A0 to 
your binary file (tour address bytes, tollowed by the appro- 
priate data--two bytes to fill the two locations specified), which 
in this case makes the new run address $A000. See COMPUTE', 
March 1982. 

1801 709 SABYTE 

Can be set greater than 7, but it only wastes memory space. 

1923 783 

Stores the drive number for the DUPSYS file. It you POKE here 
with the ASCII equivalent of the drive number (for example, 

POKE 1923,50 for drive 2), when you call DOS from BASIC, 
DUP.SYS will be loaded trom the drive specified rather than the 
default Dl:. To make a permanent change to your DOS, POKE 
the appropriate number, go to DOS, and write DOS files to a 
disk. 

3118 C2E 

POKE with 0 to change only the first of matching filenames in 
case of duplication error in your directory (normally, Rename 
changes all files of the same name). POKE with 184 ($B8) to re- 
store. From the OS/A+ manual. 

3460 D84 

Deallocation bytes of the VTOC and directory; see the next few 
locations. 


4226 1082 

LSB of the current directory sector (first of eight reserved sec- 
tors). The directory is normally located in sectors 361 -368. The 
default number here is 105 ($69). 

4229 1085 

MSB of current directory sector. To change the location of the 
directory, first copy the current sectors to the desired location 
(see 768 above), then POKE the new location of the first sector 
into the LSB/MSB bytes. That and the next seven sectors will be 
recognized as the new directory area. Finally, write the number 
for the new Start sector (sector number/8 + 10) into 3460 ($D84). 
Leave BASIC and rewrite DOS onto a newly formatted disk. DOS 
disks with the original directory locations cannot read your 
directory. 

Disk Directories 


Format of a directory entry: 

Byte Use 
0 Flag: 

$00 entry New (never used) 

$01 file opened For I/O 
$02 file created by DOS 2 
$20 file locked 
$40 file In use (normal) 

$80 file deleted 

1-2 Number of sectors In the file 
3-4 Starting sector number (LSB/MSB) 
5-12 Filename (space Or $20 If blank) 
13Ä15 Extension 


4264 10A8 
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LSB of the current VTOC (Volume Table Of Contents-only one 
sector reserved). 

4266 1OAA 

MSB of the VTOC sector, normally sector 360. The VTOC is a bit- 
map of the disk contents; after the initial Status bytes, each of 
the following bits represents one sector on the disk in sequential 
order, There are 720 sectors, but sector 0 cannot be accessed 
by the OS. Sectors 1-4 are reserved as "boot" sectors on a DOS 
disk, sectors 360-368 are reserved for the VTOC and directory 
leaving 707 free for files, You can move the VTOC the same 
way you move the directory. 

If you change the directory location (make sure there's nothing 
in the new directory location that you don't mind erasing first), 
go into the VTOC and deallocate the original directory sectors 
(write a one into the bits) and write a zero into the bits 
representing the new locationÄthis prevents them from being 
overwritten, You can also lock out sectors by deallocating them 
in the VTOC. 

Volume Table of Contents 

Byte Use 

0 DOS Code (0 = DOS 2.0) 

1-2 Total number of sectors (707; $2C3) 

3-4 Number of currently unused sectors 

5 Reserved (unused at present) 

6-9 Unused 

10-99 Bitmap: one bit For Each sector (0=ln use— 
locked; l=unused—free). The leftmost bit of 
Byte 10 ($0A) is sector 0 (see above), the Next bit 
To the right is sector 1, And so On, Until the 
rightmost bit of Byte 99 ($63), which is sector 719 
($2CF). 

100-127 Unused 

There are only 707 sectors counted in bytes 1 and 2 (not 720). 
since the first 4 are "boot" sectors, then the VTOC and directory 
take another 9, for a total of 13. 

A typical DOS 2.0 VTOC with DOS.SYS and DUP.SYS, but nothing 
eise except the boot, VTOC. and directory sectors in use; it looks 
like this: 


Byte 


0 

02 

C3 

02 

50 

02 

00 

00 

00 

8 

00 

00 

00 

00 

00 

00 

00 

00 

16 

00 

00 

00 

00 

00 

00 

00 

00 

24 

01 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

32 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

40 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

48 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

00 

56 

7F 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

64 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

72 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

80 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

88 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

FF 

96 

FF 

FF 

FF 

FF 

00 

00 

00 

00 

104 

00 

00 

00 

00 

00 

00 

00 

00 

112 

00 

00 

00 

00 

00 

00 

00 

00 

120 

00 

00 

00 

00 

00 

00 

00 

00 


The VTOC is the leftmost bit ot byte 55 ($37), and the directory 
sectors are the remainder of the byte plus the leftmost bit of 
byte 56 ($38). The leftmost four bits of byte 10 ($0A) are the boot 
sectors, and the remainder of the bytes up to and including the 
leftmost seven bits of byte 24 ($18) are in use by DOS and DUP. 
Remember that the last three bytes in the VTOC and directory 
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are not Status bytes. 

Disk directories and the VTOC (as well as many other disk mys- 
teries and delights) are explained in detail in Bill Wilkinson's 
Inside Atari DOS from COMPUTE! Books, and are somewhat dis- 
cussed in Atari Software Protection Techniques by George Mor¬ 
rison (Alpha Systems, 1983). 

4856 12F8 

Should read drive type, not tape. 

5446,5450 1546,154A 

LSB and MSB of the address the warm Start routine places in 10 
and 11 (DOSVEC). POKE your RESET handler routine address 
here to always load it back into DOSVEC when RESET is 
pressed. Point to 6047 ($179F); a USR call to 6047 loads DUP and 
sends you to the DOS menu. 

5576 15C8 

You can run some machine language programs from within 
BASIC by typing OPEN #1,4,0, "D:filename" then 
X=USR(5576). CLOSE the channel afterward if you return to 
BASIC. 

40960 A000 

A USR here will cold Start the BASIC Cartridge. If you're handy 
with machine code, you can add commands to BASIC by trap- 
ping the keystrokes betöre they get passed on to the editor. 

Charles Brannon describes how to do this (with a good pro¬ 
gram of commands) in COMPUTEI's Third Book of Atari. 

53260 D00C SIZEM 

POKE with 255 to quadruple the size of all missiles. 

53268 DOM PAL 

NTSC Systems have 60 frames per second and 262 lines per 
frame; PAL Systems have 50 frames and 312 lines. Should read 
13 decimal, not 14. 

53768 D208 AUDCTL 

Frequencies are rounded off; they are actually 63.9210 kilo- 
hertz, 15.6999 kilohertz, and 1.78979 megahertz. You can use the 
frequency to calculate the POKEY Interrupt frequency by 
INTFREQ = clock frequency/(2 * (1 + value in AUDF register 
for that channel)). 

COMPUTEI's Third Book of Atari has articles by Matt Giwer and 
Fred Tedsen on using POKEs to control the sound effects, the au¬ 
dio Channels, and AUDCTL. 

53770 D20A RANDOM 

For example, random 0 to 9 would be INT(PEEK(53770) 

*10/256) and 0 to 99 would be INT(PEEK(53770)*100/256). 

54272 D400 DMACTL 

POKE with zero to blank out screen. 

54286 D40E NMIEN 

POKE with zero, and VBLANK and System clock are disabled, 
and shadowing is suspended. See COMPUTE! magazine, June 
1983 (p. 254), for a method of trapping the RESET key in BASIC. 
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57344 EOOO Character set 

See COMPUTE! magazine, June 1983 (p. 226). 

58368-58447 E400-E44F Händler vectors 

Each vector consists of a 15-byte table, 2 bytes each for OPEN, 
CLOSE, GET byte, PUT byte, Get Status, and Special routine ad- 
dresses, The next 3 bytes are a JMP instruction followed by the 
address of the initialization routine for that handler. A zero 
separates handlers (byte 16). Here are the locations for each 
routine in the table: 


Händler 

E: 

Open 

E400 

58368 

Close 

E402 

58370 

Get 

E404 

58372 

PUT 

E406 

58374 

Status 

E408 

58376 

Special 

E40A 

58378 

JMP 

E40C 

58380 

S: 

E410 

58384 

E412 

58386 

E414 

58388 

E416 

58390 

E418 

58392 

E41A 

58394 

E41C 

58396 

K: 

E420 

58400 

E422 

58402 

E424 

58404 

E42 6 
58406 

E428 

58408 

E42A 

58410 

E42C 

58412 

P: 

E430 

58416 

E432 

58418 

E434 

58420 

E436 

58422 

E438 

58424 

E43A 

58426 

E43C 

58428 

C: 

E440 

58432 

E442 

58434 

E444 

58436 

E446 

58438 

E448 

58440 

E44A 

58442 

E44C 

58444 


58451 E453 DSKINV 

Takes its information from the bytes in the lower part of page 

three ($300) for Operation. The vectors between 58448 and 
58496 ($E450-$E480) are all three-byte vectors; a JMP instruction 
followed by an address in LSB/MSB format. 

58454 E456 CIOV 

Page 147: IOCB number times 16 in the X register. The X register 

becomes the CIO channel number. Since the screen is always 
open for channel 0, when using the screen you make the X reg¬ 
ister 0 as well. Bill Wilkinson says that to output a single charac¬ 
ter through the CIO instead of an entire butter (the normal 
occurrence), set the butter length to 0. This forces the I/O to in- 
put or output a single character only. See COMPUTE!, January 
1985. 


58457 E459 SIOV 

Here are the pinouts for the serial I/O jack: 


/ \ 

/ 2 4 6 8 10 12 \ 

/ \ 
/I 3 5 7 9 11 13 \ 

/ _ \ 


1 Clock Input 
3 Data Input 
5 Data Output 
7 Command 
9 Proceed 
11 Audio Input 
13 Interrupt 


2 Clock Output 
4 Ground 
6 Ground 
8 Motor control 
10 + 5v dc/Ready 
12 +12v de 


58484 E474 WARMSV 

Do a USR here to warm Start the Computer. 

58487 E477 COLDSV 

Do a USR here to cold Start the Computer. 

59280,81 E790,91 ? 

Seems to be the same DU vector address as 512-513. 
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GTIA Graphics Modes 

Graphics modes 9, 10, and 11 are unique to the GTIA Chip; the early CTIA Chip didn't have them. 
Of course, the GTIA is Standard now in all later model 400, 800, XL, and XE models. The GTIA 
modes all use 8138 bytes of RAM, have 80 X 192 full-screen (no text window) resolution, and have 
no border color. Each pixel is a wide, but short, rectangle with a ratio of 4:1 for width to height. 

Each pixel uses four bits. Here's a small chart which summarizes these modes. 


GR# Colors 
9 1 (16 lum) 


10 9 


SETCOLOR Registers 
4 712 Use the COLOR com- 

mand (0-15) for 
luminance 


0 

704 

Must be POKEd 

1 

705 

Must be POKEd 

2 

706 

Must be POKEd 

3 

707 

Must be POKEd 

4 

708 

Use COLOR 0 

5 

709 

COLOR 1 

6 

710 

COLOR 2 

7 

711 

COLOR 3 

8 

712 

COLOR 4(BAK) 


11 1 (16 hues) 4 


712 Use COLOR command 
(0-15) for hue 


Information on GTIA modes has been published in many books and magazines, including De Re 
Atari and Your Atari Computer by Poole et al. (a revised edition of the latter is available now). An 
example of adding a text window to a GTIA screen by way of a DLI was in David Sander's article in 
Antic, April 1983. 
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16 Appendix 12 - XL/XE Memory Map 

Most of the information in the first edition of Mapping the Atari applies equally well to the XL and 
XE lines of Computers; only those locations below represent known changes. Atari made several 
changes to RAM locations, and the OS was almost entirely rewritten in the newer models. 

The information here pertains to the 600XL, 800XL, 1200XL, 65XE, and 130XE. Except for the 
1200XL, the XL and XE models are virtually identical to each other. There have been changes in 
the BASIC ROMs, but I have no official word on any changes in the OS. although I have reason to 
believe there have been some. 

For those owners of XL Computers who have difficulty using older 800 Software, Atari (and several 
other Companies) makes a Translator disk which loads an 800 operating System on top of the XL 
OS, allowing you to run almost all 800 programs. Ask your local Atari dealer for this disk if you don't 
already have it. Side A of the Translator disk permits you to press RESET and usually remain 
within the older OS; side B doesn't have this code patch. so it reboots the XL OS when RESET is 
pressed. A public domain translator called FIXXL is also available on CompuServe. A hardware 
solution is available: the XL BOSS Chip from Allen MacroWare. 

The DDT subprogram in OSS's MAC/65 assembler is an excellent tool for examining memory, 
especially since it gives you the Option of ASCII display and disassembly of visible memory. It 
allows you to write directly to memory or jump to any location. I used it constantly while writing this 
chapter. 

Unless otherwise noted, this material pertains to all XL and XE models (as does much of the 
earlier section of the book). RAM locations and interrupt and OS vectors will remain the same in all 
Systems; however, the locations and contents of routines they point to may differ among 
Computers. Not all of the OS ROM locations described here will be the same in the 1200XL. Some 
of the changes here are to vec tors, not to functions. References to function keys (Fl to F4) and 
LEDs are for 1200XL users only. My original 1200XL memory map appeared in COMPUTERS Third 
Book of Atari. 

Most RAM and hardware locations belonging to the GTIA, ANTIC, POKEY, and PIA Chips (53248- 
55295; $D000-$D7FF except for PORTB) have generally not changed. The floating-point package 
remains at 55296-57343 ($D800-$DFFF), but routines have been altered within it. The major 
change in the OS was the shifting of interrupt handlers from high ROM into the area previously 
unused between 49152 and 52223 ($C000-$CBFF) and the addition of the international character 
set at 52224-53247 ($CC00-$CFFF). 

Atari promises the XE series will maintain 100 percent compatibility with the XL series-as long as 
the Software obeys the "rules" and sticks to official, published vectors and entry points and doesn't 
try to take advantage of some ROM routine to save a few bytes (see 62026 and 62128 below). The 
OS in the XE series is the same as that in the 800XL, at least at the time of this writing. When the 
ROM routine gets moved--the Software crashes. Don't blame Atari; they’ve published this material 
since day one. If developers don't pay attention, it's not Atari's fault. 

Deleted Registers 

The following registers have been completely deleted from the XL/XE, and other uses have been 
found for the location (previous 400/800 locations given): 

PTEMP (31; $IF) 

LINBUF (583-622; $247-$26E) 

CSTAT (648; $288) 

TMPXI (668; $29C) 

HOLD5 (701; $2BD) 

ADDCOR (782; $30E). 

00 00 LNFLG 

Used by the Atari in-house debugging programs and OS on 
power-up. 

01 01 NGFLAG 
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Used during power-up routines for self-testing; checks for bad 
memory bytes; zero means memory failure. 

07 07 CMCMD 

Command flag for 835 and 1030 modems set to any nonzero 
number to pass commands to the modern. Used to be TSTDAT. 

10,11 A,B DOSVEC 

Points to 6047 ($179F). 

12,13 C,D DOSINI 

Points to 5440 ($1540). 

28-31 1C-1F ABUFPT 

Intended OS use as buffer pointers; currently unused. 

54,55 36,37 LTEMP 

Temporary buffers for the general-purpose peripheral handler 
loader routines. The general-purpose handler routines help the 
OS deal with new handlers and peripherals which load their 
own handlers. All locations marked as being used by the 
peripheral handler or loader are tar OS use only; do not use 
them. 

74,75 4A,4B ZCHAIN 

Temporary storage registers for general-purpose peripheral 
handler loader. 

96,97 60,61 FKDEF 

The 1200XL has four redefinable function keys. FKDEF points 
(LSB/MSB) to their definition table-an eight-byte table for keys 
Fl to F4 and then SHIFT-F1 to SFIIFT-F4. Each byte is assigned a 
value corresponding to an internal (not ASCII) code. The keys 
themselves are values 138-141 ($8A-$8D), but you must not as- 
sign a key its own value since it generates an endless loop. Ini- 
tially points to 64529 ($FC11). 

The function keys perform the following activities: 

Key Combination Function 
Fl Cursor up (ATASCII 28; $1C) 

F2 Cursor down (29; $1D) 

F3 Cursor left (30; $1E) 

F4 Cursor right (31; $1F) 

With SHIFT 

Fl Home (Cursor to upper left, 28; $1C) 

F2 Cursor to lower-left corner (29; $1D) 

F3 Cursor to Start of physical line (30; $1E) 

F4 Cursor to right end of physical line (31; 

$1F) 

With CTRL 

Fl Keyboard enable/disable toggle (not con- 

sole keys) 

F2 Screen display enable/disable 

F3 Key click sound enable/disable 

F4 Domestic/international character set 

toggle 

Function keys are ignored with both a SHIFT and CTRL 
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combination. You cannot redefine CTRL-function key definitions. 

98 62 PALNTS 

Flag to determine PAL or NTSC Version of the display handler, 
previously at 53268 ($D014). Zero means North American 
Standard. 

121,122 79,7A KEYDEF 

Pointer (LSB/MSB) to the keyboard definition table, initialized to 
64337 ($FB51), where the System keyboard table resides. You 
can redefine the keyboard by writing a 192-byte table and 
POKEing its address here. The table consists of three 64-byte 
portions: lowercase keys, SHIFTed keys, and CTRL keys. The Sys¬ 
tem table has the following assignments: 


Byte Key 

00 1 

01 j 

02 ; 

03 Fl (1200XL) 

04 F2 (1200XL) 

05 k 

06 + 

07 * 

08 o 

09 (128; see below) 

10 p 

11 u 

12 Return 

13 i 

14 

15 

16 v 

17 HELP (128) 

18 c 

19 F3 (1200XL) 

20 F4 (1200XL) 

21 b 

22 x 

23 z 

24 4 

25 (128) 

26 3 

27 6 

28 ESC 

29 5 

30 2 

31 1 


Byte Key 

32 

33 Space 

34 

35 n 

36 (128) 

37 m 

38 / 

39 Inverse key (114) 

40 r 

41 (128) 

42 e 

43 y 

4 4 Tab 

45 t 

4 6 w 

47 q 

48 9 

49 (128) 

50 0 

51 7 

52 BACKSPACE 

53 8 

54 < 

55 > 

56 f 

57 h 

58 d 

59 (128) 

60 CAPS (130) 

61 g 

62 s 

63 a 


The next 64 bytes contain the shifted characters (for example, a 
shifted is A, 5 shifted is %; look at the upper characters on your 
keyboard). The following 64 are CTRL key characters (many 
graphics characters), You have to create a table for all 192 
bytes, although you need change key assignments only for a 
specific few. Use the ATASCII values when writing the table. 

Several values have specific meaning to the keyboard decoder 


on the XL: 


Dec/Hex 

Use 

128/80 

Not used; invalid combination 

129/81 

Inverse Output 

130/82 

Upper/lowercase toggle 

131/83 

CAPS Lock 

132/84 

CTRL key Lock 

133/85 

End of file (EOF) 

137/89 

Keyboard click toggle 

138-141/8A-8D 

Function keys F1-F4 (1200XL only) Or: 
Cursor up (ATASCII 28; $1C) 

Cursor down (ATASCII 30; $1D) 

Cursor left (ATASCII 31; $1E) 

Cursor right (ATASCII 32; $1F) 

142/8E 

Cursor home (upper-left screen corner) 
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143/8F Cursor To bottom-left corner 

144/90 Cursor To left margin (1200) 

145/91 Cursor To right margin (1200) 

You can't redefine BREAK, SHIFT, CTRL, or the console keys (nor 
the CTRL-function key assignments on the 1200XL). The 1200XL 
Addenda gives a Dvorak keyboard assignment easily written 
into memory, The System table address is returned to RAM on 
power-up or RESET. 

128,129 80,8 1 LOMEM 

Points to 7676 ($$1 DFC). 

512-551 200-227 Interrupt vectors 

The locations of the vectors and their functions remain the 
same, but they now point to different locations in the OS 


memory: 

Vector 

Hex 

Label 

Points To 

512,513 

200,201 

VDSLST 

49358 

($C0CE) 

514,515 

202,203 

VPRCED 

49357 

($C0CD) 

516,517 

204,205 

VINTER 

49357 

($C0CD) 

518,519 

206,207 

VBREAK 

49357 

($C0CD) 

520,521 

208,209 

VKEYBD 

64537 

($FC19) 

522,523 

20A,20B 

VSERIN 

6691 

($1A23) 

524,525 

20C,20D 

VSEROR 

6630 

($19E6) 

526,527 

20E,20F 

VSEROC 

60140 

($EAEC) 

528,529 

210,211 

VTIMR1 

49357 

($C0CD) 

530,531 

212,213 

VTIMR2 

49357 

($C0CD) 

532,533 

214,215 

VTIMR3 

49357 

($C0CD) 

534,535 

216,217 

VIMIRQ 

49200 

($C 0 3 0) 

546, 547 

222,223 

WBLKI 

49378 

($C0E2) 

548,549 

224,225 

WBLKD 

49802 

($C28A) 

550,551 

226,227 

CDTMA1 

60433 

($EC11) 


The OS was rewritten in the XL/XE models, moving the interrupt 
handlers down into the previously unused region 49152-53247 
($C000-$CFFF). 

563 233 LCOUNT 

Temporary counter for peripheral handler loader. 

566,567 236,237 BRKKY 

Now points to 49298 ($C092). 

568,569 238,239 RELADR(1200XL) 

VPIRQ (All XL/XEs 
except 1200XL) 

Previously spare bytes, now the address of the relocatable 
loader routine in the 1200XL and vector for parallel bus inter¬ 
rupt requests on all XL/XEs except 1200XL (where it points to a 
routine at 51566; $C96E)-the vector for any initialized generic 
parallel device. 

581 245 RECLEN 

Relocatable loader routine variable for record length. 

583-618 $247-$26A 

Reserved (unused) on the 1200XL. 

583 247 PDVMSK 

Shadow mask for the device selection register at 53759 ($D1 FF; 
active only when the OS deselects the floating-point ROM by 
writing to that address). You can run up to eight parallel de- 
vices through the bus; each bit in this register corresponds to 
one device. The mask must be set for the proper device betöre 
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the OS will allow an IRQ to be sent to that device. 

584 248 SHPDVS 

Shadow for parallel bus register; each bit represents one of 
eight parallel devices. Allows the OS to Service VBIs while run- 
ning the device masked by this bit. 

585 249 PDMSK 

Parallel bus Interrupt mask; allows OS to Service IRQs from the 
device masked by the bit in this register. See above. 

586,587 24A,24B RELADR 

Relocatable loader relative address. 

588,589 24C,24D PPTMPA,PPTMPX 

One-byte temporary storage registers for relocatable loader. 

590-618 24E-26A 

Spare bytes, reserved for future use. 

619 26B CHSALT 

Alternate character set pointer for the 1200XL, initialized to 204 
($CC) to point to the international character set as the next set 
to display on the CTRL-F4 toggle. The XL has two internal 
character sets, one at 52224 ($CC00) and the other at 57344 
($E000). 

620 26C VSFLAG 

Fine-scroll temporary register. 

621 26D KEYDIS 

Keyboard disable. POKE with 255 to disable the keyboard, 0 to 
reenable. You have to press RESET (all XL/XEs except 1200XL) to 
get control back if you are locked out; 1200XL users can press 
CTRL-F1 (toggles it on and off; LED 1 is on when the keyboard is 
disabled). 

622 26E FINE 

Fine-scroll enable for graphics mode 0 (text); POKE with 0 for 
coarse Scrolling (the default) and 255 ($FF) for fine scrolling. 

Follow the POKE with GR.O or an OPEN for device E:. Try listing 
a long program-it's slow and smooth! The display list for fine 
scrolling is one byte longer than for coarse scrolling. The OS 
places the address (64708; $FCC4) of a Display List Interrupt 
(DLI) at 512, 513 ($200,201), replacing any you might have 
placed there. The color register at 53271 ($D017) is altered for 
the last visible screen line. 

If you enable fine scrolling and go immediately to DOS, you'll 
see that it's still enabled when you do a copy to screen or disk 
directory. Jerry White wrote an article demonstrating fine 
scrolling and other XL features in Analog, February 1984. 

628-631 272-277 PADDL4-7 

The XL has only two ports, so only paddles 0-3 are active. 

634-635 27A-27B STICK2-3 

No longer in use since there are ports only for sticks 0 and 1. 

The OS VBLANK process now copies the PORTA joystick (0-1) 
and paddle (0-3) values into the shadow registers for PORTB so 
that STICK0 affects both STICK0 and STICK2, STICK1 affects 
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STICK1 and STICK3, PADDLO affects PADDLEO and PADDL4, and 
so on. 

640-643 280-283 PTRIG4-7 

No longer in use (see PADDL4-7). 

646-647 286-287 STRIG2-3 

No longer in use (see STICK2-3). 

648 288 HIBYTE 

High-byte register for relocatable loader routine. 

651 28B IMASK 

Unused. 

652 28C JVECK 

Temporary jump vector; unused. 

654,655 28E,28F NEWADR 

Used by relocatable loader; new address vector. 

668 29C CRETRY 

Number of command retries; moved from 54 ($36) in the 
400/800. 

701 2BD DRETRY 

Number of device retries; moved from 55 ($37) in the 400/800. 

713,714 2C9,2CA RUNADR 

Run address register for relocatable loader routine. 

715,716 2CB,2CC HIUSED 

Used by relocatable loader routines. 

717,718 2CD,2CE ZHIUSE 

Used by relocatable loader routines. 

719,720 2CF,2D0 GBYTEA 

Used by relocatable loader routines. 

721,722 2D1.2D2 LOADAD 

Used by relocatable loader routines. 

723,724 2D3,2D4 ZLOADA 

Used by relocatable loader routines. 

725,726 2D5,2D6 DSCTLN 

Disk sector size register; default of 128 ($80) bytes, but can be 
altered to a length from 0 to 65535 ($FFFF). Your drive may not 
support other sizes, however. 

717,728 2D7,2D8 ACMISR 

Interrupt Service routine address; unused. 

729 2D9 KRPDEL 

Auto-delay rate; the time elapsed betöre keyboard repeat be- 
gins. Initially set at 48 ($30; $28 for PAL machines) for 0.8 sec- 
onds; you can POKE it with the number of VBLANK intervals 
(1/60 second each) betöre repeat begins. A value of 60 would 
be a one-second delay. A value of 0 means no repeat. 
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730 2DA KEYREP 

The rate of the repeat; default is 6, which means ten characters 
per second (one each six VBLANK intervals after the delay 
above). POKE with the number of VBLANK intervals between 
repeats; with a value of 1, you get 60 characters per second (50 
on PAL Systems)! A value of 0 provides one key repeat only per 
press. 

731 2DB NOCLIK 

This is the keyboard click disable register; POKE with any non- 
zero number to disable the annoying keyboard sound pro- 
duced through your TV. POKE again with 0 to enable the sound. 
On the 1200XL, CTRL-F3 toggles the sound as well. 

732 2DC HELPFG 

Register to hold the HELP key Status; 17 is HELP has been 
pressed alone, 81 means it has been pressed with SHIFT, and 
145 with CTRL. This register can be cleared under program 
control only by POKEing it with 0. The OS ignores it otherwise. 

733 2DD DMASAV 

This saves the DMA value from 559 ($22F) on the 1200XL when 
CTRL-F2 is pressed to disable the screen. On all XL/XEs except 
the 1200XL, if you POKE 559,0 to turn off the screen, the value is 
not saved in 733. However, if you POKE 733 with the DMA value 
(usually 34) at the next keystroke, the screen will automatically 
be activated again. 

734 2DE PBPNT 

Print buffer pointer; moved from 29 ($1D) on the 400/800. 

735 2DF PBUFSZ 

Print buffer size; moved from 30 ($1E) on the 400/800. 

745 2E9 HNDLOD 

Relocatable loader routine handler flag. 

746-749 2EA-2ED DVSTAT 

Additional device Status registers to contain Information re- 
turned to the Computer by the peripheral after the new type 3 
and 4 polls. The bytes contain: 

746/747 LSB/MSB of the handler size (must be an even 
number) 

748 Device SIO address to be used for loading 

749 Peripheral revision number 

The new poll types are fully explained in the 1200XL operating 
System manual; earlier poll types are described in the 400/800 
hardware manual. Basically, type 3 is an "are you there?" poll 
(device address $4F, command byte $40, AUX1 $4F, AUX2 $4F, 
checksum normal), and poll 4 is a null poll (values $4F, $40, $4E 
and $4E, respectively; checksum normal). 

756 2F4 CH BAS 

Character set select; default of 224. The international set can be 
selected by POKE 756,204 ($CC). On the 1200XL, the value in 
CHBAS is switched with that in CHSALT (619; $26B) whenever 
CTRL-F4 is used to toggle the alternate character set. The val¬ 
ues in the two registers are swapped and LED 2 is lit. 
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757 2F5 NEWROW 

Moved from 96 ($60) in the 400/800. 

758,759 2F6,2F7 NEWCOL 

Moved from 97,98 ($61 ,$62) in the 400/800. 

760 2F8 ROWINC 

Moved from 121 ($79) in the 400/800. 

761 2F9 COLINC 

Moved from 122 ($7A) in the 400/800. 

782 30E JMPERS 

Storage for hardware Option jumpers on the 1200XL, intended to 
teil the OS how the System is configured; if bit 0 (POT 4) is not set 
(0), then the self-test will run. Bits 1-7 are unused. Used only in 
the 1200XL. 


787 313 TEMP2 

One-byte temporary storage register. 

788 314 PTIMOT 

Moved from 28 ($1C) in the 400/800. Same initial value (30). 

829-831 33D-33F PUPBT1-3 

Power-up and reset validation registers 1-3. Used on warm Start 
to verify the integrity of memory. The OS initializes these loca- 
tions to 92 ($5C), 147 ($93), and 37 ($25), respectively. When RE¬ 
SET is pressed, these bytes are checked, and it they are the 
same as initialized, a warm Start is done; otherwise, a cold Start 
occurs. 

838,839 346,347 IOCB0 

To send your output to the printer, POKE 838,202 and POKE 
839,254. To turn off the printer and send everything back to the 
screen, POKE 838,175 and POKE 839,242. This program from 
Matt Ratcliff allows you to toggle output between printer and 
screen by pressing SELECT (it works equally well on the 
400/800): 

10 Dim A$(1):CONSOL=53279:GRAPHICS 0:IOCB0E=838 
20 PHDLR=58422 
30 EHDLR=58374 

40 PL=PEEK(PHDLR):PH=PEEK(PHDLR+1) 

50 EL=PEEK(EHDLR):EH=PEEK(EHDLR+1) 

60 Print "Text will print continuously." 

70 Print "Press SELECT to toggle output" 

80 Print "between printer and screen.":? 

90 Print "Get printer ready and press RETURN" 

100 Input A$:1=1:DIR=0 

110 Print I;" Press select to change output1=1+1 
120 If PEEK(CONSOL)<>5 Then 110 

130 If DIR Then POKE IOCB0E,EL:POKE IOCB0E+l,EH 

140 If Not DIR Then POKE IOCB0E,PL:POKE IOCB0E+l,PH 

150 DIR= Not DIR 

160 If PEEK(CONSOL)<>7 Then 160 

170 GoTo 110 

1000 3E8 SUPERF 

Screen editor register; cleared on entry to the "put byte" rou- 
tine, the editor changes keycodes 142-145 ($8E-$91) to 28-31 

($1 C-$1 F; see 121; $79) and sets SUPERF to nonzero. 

1001 3E9 CKEY 

Moved from 74 ($4A) in the 400/800. 
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1002 3EA CASSBT 

Moved from 75 ($4B) in the 400/800. 

1003 3EB CARTCK 

Cartridge checksum. A checksum of page one of the cartridge. 

The checksum is recalculated each VBLANK and checked 
against this register. If not the same, the OS assumes the car¬ 
tridge isn't there any more (was pulled out) and does a cold 
Start; 1200XL only. 

1004 3EC DERRF 

Screen open error flag; if zero, then no error, if nonzero, then OS 
can't initialize the screen editor. 

1005-1015 3ED-3F7 ACMVAR 

Reserved for OS variables; on power-up or cold Start, all vari¬ 
ables between 1005 and 1023 ($3ED-$3FF), inclusive, are set to 
zero, but are left unchanged on warm Start. 

1016 3F8 BASICF 

Shadow of current Status of BASIC. Zero means ROM BASIC is 
enabled; nonzero means it's not. Must be in sync with disabling 
of ROM BASIC. To disable BASIC, set BASICF to nonzero, then do 
a warm Start (press RESET); DOS will load and teil you there is 
no cartridge present when you try to return to BASIC. 

1017 3F9 MINTLK 

Unused. 

1018 3FA GINTLK 

Cartridge interlock register; the complement of BASICF, above. 

It reads 1 when an external cartridge is installed, 0 when not 
(or ROM BASIC is in use). The value of TRIG3 (53267; $D103) is 
loaded here by the OS initialization routine. If at any time, the 
external cartridge is pulled, the System will crash. 

1019,1020 3FB,3FC CHLINK 

Relocatable handler chain use; allows chaining of portions of 
handler routines. 

1792-7419 700-1CFB 

Used by DOS when loaded; otherwise available as free RAM. 

3889 F31 DOS 3 

If you PEEK here and get 76 ($4C), you have an early Version of 
DOS 3 (the later Version will read 78). To correct some errors in 
the earlier FMS files, type this in: 

10 For N=1 To 9: Read A,B:POKE A,B: Next N 
20 DATA 3889, 78,3923, 78,3943,78,3929, 76, 3895,76 
30 DATA 3901,77,3935,77,3955,77,2117,240 

Better yet, get DOS 2.5 from Atari (supports double-density and 
the 130XE RAMdisk). DOS 3.0 saves in blocks, not sectors-of a 
minimum 1000 bytes per block. If you write a program 1001 
bytes long, it saves 2000 bytes, wasting 999 bytes on your disk. 

20480-22527 $5000-$57FF Self-test ROM 

Self-test ROM when enabled, controlled by bit 7 of PORTB 
(54017; $D301). The self-test code is in a special ROM area 
underneath the GTIA, POKEY, ANTIC Chips area (starting at 
53248; $D3000) and is moved (remapped) here when you type 
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BYE in BASIC or when you POKE PORTB with the right value and 
JMP (or USR) to the initialization vector (see 58481; $E471 and 
58496-58499, $E480-$E483). RAM when self-test isn't enabled. 

39967-40959 9C1F-9FFF .... 

Display list and screen RAM, moved into lower memory if a 
cartridge is 16K (using RAM from 32767 to 49151 as well). 

43234 A8E2 BASIC ROM 

If you PEEK here and get 96 ($60), you have the BASIC Revision 
B ROMs. What you need is Revision C. B Stands for Bugs! See 
Appendix 13 on enhancements and bugs. If you get 234 ($EA), 
you have Revision C. From Matt Ratcliff. 

You can turn BASIC off when you go to DOS by POKEing 1016 
($3F8), then pressing RESET. The problem is to turn it back on 
again from DOS rather than rebooting the System. There is a 
public domain program by Matt Ratcliff on the Gateway BBS 
which does this for you. 

Introduction to the OS ROM 

Atari modified the new XL/XE ROMs since Revision B. Atari main- tained the handler and interrupt 
vectors, although the routines they point to changed between versions. 

Atari did produce a listed source code for the XL OS, although for some reason it was never 
published for public sale as it was in- tended. It may be available now through Atari-write and ask 
for it. It is an excellent 500+ page resource document. 

49152-52223 C000-CBFF Interrupt handlers 

Os ROM. In the 400/800, the block between 49152 and 53247 
was unused; now the area holds many of the interrupt handlers 
(vectored here from page two). Some 400/800 Software checks 
for certain values in these locations and won't run if the value is 
not found. Use the Translator disk in that case (with the 400/800 
OS installed; the area between $C000 and $CEFF becomes user- 
accessible RAM). The area between 52069 ($CB65) and 52223 
($CBFF) is empty (all zeros). 

A lot of interrupts are set to jump to 49357 or 49358 ($C0CD or 
$C0CE). The former contains a PLA Statement followed by an 
RTI. The net result is a simple return back into the program 
without any other activity taking place. 

Bytes 49152-49163 ($C000-$C00B) are used to identify the Com¬ 
puter and the ROM in the $C000-$DFFF block: 


Byte 

Use 

4 9152-3/C000-1 

Checksum (LSB/MSB) of all the bytes 
In ROM except the checksum bytes 
themselves. 

49154/C002 

Revision Date, stored In the form 
DDMMYY. This is DD, day, usually $10 

4 9155/C003 

Revision Date, month; usually $05. 

49156/C004 

Revision Date, year; usually $83. 

49157/C005 

Reserved Option Byte; reads zero For 
the 1200, 800XL, And 130XE. 

49158/C006 

Part number In the form AANNNNNN; 

AA is an ASCII character And 

NNNNNN is a four-bit BCD digit. This 
Byte Al. 

49159-62/C007-A 

Part number, bytes A2, N1-N6 (Each 
Byte has two N values of four bits 
Each) . 

49163/C00B 

Revision number. My 800XL And 

130XE say 2. 
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49164/C00C Interrupt handler initialization 

49176/C018 NMI intitialization 


Interrupt handlers And other routines In the $C000 block: 


Entry 

49196/C02C 

4 92 98/CO 92 

49312/C0A0 

49359/COCF 

4 9378/C0E2 

4 9743/C24F 

49890/C2E2 

49749/C255 

49778/C272 

49802/C28A 

49808/C290 

49834/C2AA 

49864/C2C8 

49866/C2CA 

50217/C42 9 
50220/C42C 
50237/C43D 
50248/C448 
50251/C44B 

50289/C471 


50394/C4DA 
50485/C535 
50571/C58B 
50619/C5BB 
50 633/C5C9 
50729/C629 
50747/C63B 
50750/C63E 
50777/C659 
50798/C66E 
50851/C6A3 
50867/C6B3 
51002/C73A 
51013/C745 

51093/C795 
51151/C7CF 
51154/C7D2 
51157/C7D5 
51281/C851 
51309/C86D 
51346/C892 
51452/C8FC 
514 68/C90C 
51507/C933 

51631/C9AF 
51658/C9CA 
51753/CA29 
51799/CA57 

52054/CB56 


Handler Or Use 
IRQ processor 
BREAK key IRQ 
Continue IRQ Processing 

Table of IRQ types And Offsets (16 bytes) 

Immediate VBLANK NMI processing 

Process Countdown timer 1 expiration 

Process Countdown timer 2 expiration 

Decrement Countdown timer 

Set VBLANK parameters 

Process deferred VBLANK NMI 

Perform warm Start 

Process RESET 

Perform cold Start 

Preset memory (cold And warm Start 
continuation) 

Initialize Cartridge Software 
Process ACMI interrupt 
BOOT Error message 
Screen editor specification (E:) 

Table of interrupt handler vectors (same Or¬ 
der As RAM vectors at 512-549 ($200—$225) 
Miscellaneous initialization routines: OP¬ 
TION key Status checked at 50330 ($C49A); 

BASIC enabled at 50337 ($C4A1) 

Hardware initialization 

Software And RAM variable initialization 

Attempt disk boot 

Boot And initialize disk 

Complete boot And initialize 

Execute boot loader 

Initialize booted Software 

Display BOOT Error message 

Get Next sector routine 

Attempt cassette boot 

Initialize DIO (disk I/O) 

Disk I/O (DIO) 

Set buffer address 

Relocate relocatable routine To New 
address 

Handle End record Type 
Get Byte 

Execute run at address 

Handle Text record 

Relocate Text into memory 

Handle word reference record Type 

Handle low-Byte And one-Byte record Type 

Select And execute self-test 

Initialize generic parallel device 

PIO—parallel device I/O; PIO vector tables 

(see 58368, $E400) begin at 51601 ($C991) 

Select Next parallel device 

Invoke parallel device handler 

Load And initialize peripheral handler 

Start of self-test Offsets And Text (uses hard- 

ware values For character display) 

Checksum linkage table 


52224-53247 CC00-CFFF CHARSET2 

International character set, assembled in the same manner as 
the Standard character set at 57344 ($E000). There are two 
character sets in the XL series, and you can switch between 
them by POKE 756,224 (Standard) or POKE 756,204 
(international). 

53279 D01F CONSOL 

If you hold down the OPTION key when booting an application 
on the XL, you disable BASIC (but no other cartridge), allowing 
the memory space to be used for applications, You generally 
need to keep the key held down only for the first few seconds of 
the boot. 
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53504-53759 D100-D1FF 

Unused in both the 400/800 and XL models by the OS, this area 
is switched out when an external device connected to the 
expansion bus is selected and the device memory switched in. 

The Situation is reversed when the device I/O is completed. 

Locations Hex Use 

53504-53758 D100-D1FE Device registers 

53504 Dl 00 Hardware get and put register 

(HWGET, HWPUT); data from 
the device on the bus is stored 
here. 

53505 Dl 01 Hardware reset and Status reg¬ 

ister (HWRSET for write-this re- 
sets the get/put register; 

HWSTAT for read). 

53759 Dl FF Hardware select register, shad- 

owed by byte 583 ($247). Bit 0 
is device 0, bit 1 device 1, and 
so on. Writing to this byte de- 
selects the FP ROM and selects 
the device ROM (try looking at 
it and subsequent locations 
with MAC/65's DDT or a similar 
tool while altering $D1 FF). 

54017 D301 PORTB 

Since the XL and XE series no longer have a PORT B (on the 
400/800 this Controls joystick ports 3 and 4), this register is used 
for LED control (1200XL only) and memory management. 

You can disable the ROM between 49152-53247 ($C000-$CFFF) 
and 55296-65535 ($D800-$FFFF) by setting bit 0 to 0 (the ROM 
area becomes RAM; note that the area between $D000 and 
$D7FF remains intact). However, unless another OS has been 
provided, the System will crash at the next interrupt (1/60 sec- 
ond later!), so you need to disable the Interrupts first. 

Bit 1 Controls BASIC; if 0, BASIC is enabled, if 1, it is disabled 
and the 8K RAM space enabled for program use. If you disable 
BASIC within a BASIC program, you lock up. Disable BASIC dur- 
ing a boot Operation by holding down the OPTION key. 

Bits 2 and 3 control the 1200XL LEDs; 0 means on, 1 means off. 
LED 1 means the keyboard is disabled; LED 2 means the inter¬ 
national character set is selected. In the 130XE, these bits are 
used for bank switching 16K blocks of RAM. The 130XE allows 
you to use the extra memory as Video memory or program/ 
data memory. See the section on memory management in the 
130XE at the end of this chapter. 

Bits 4-6 are reserved (unused) in the XL and 65XE. Bits 4 and 5 
in the 130XE are used to enable bank switching (see below). 

Bit 7 Controls the RAM region 20480-22527 ($5000-$57FF), nor- 
mally enabled 1). When disabled 0), the OS ROM in that area is 
enabled and access provided to the self-test code moved from 
53248-55295 ($D000-$D7FF). 

Try this: POKE 54017,PEEK(54017)-128 to enable the self-test 
ROM. Now type X=USR(20480). The self-test screen appears. The 
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RAM is reset on power-up or warm Start. Of course, you can al- 
ways simply type BYE to enter the test routines as well. 


Here's a program from Joe Miller of Koala Technologies which 
copies portions (skips the $D000-$D7FF block) of the OS into 
RAM, disables the ROM, then moves the copied portion back: 


100 

110 

120 

130 

190 

200 

210 

220 

230 

240 

250 

260 

270 

275 

280 

290 

300 

310 

320 

330 

340 

350 

360 

370 

380 

390 

400 

410 

420 

430 

440 


REM RAMROM - Install RAMÄbased 

REM OS In an XL Computer 

REM by Joe Miller 

REM March 23, 1985 

Print "MOVING OS INTO RAM" 

For 1=1536 To 1635 
Read B:POKE I,B:Next I 
B=USR (1536) 

Print CHR$(125) 

Print "RAM OS INSTALLED" 

Print "PRESS RETURN TO TEST IT" 
Print :Print :Print 
Print "POKE 57344,1" 

Print "{5 SPACES}$E000=1 Print 
Print "POKE 57344,0" 

POSITION 1,4 

DATA 169,0,133,203,133,205,169 
DATA 192,133, 204,169, 64, 133,206 
DATA 160,0,177,203,145,205,200 
DATA 208,249,230,206,230,204,240 
DATA 12,165,204,201,208,208,237 
DATA 169,216,133,204,208,231,8 
DATA 120, 173, 14,212,72,169,0 
DATA 141,14,212,173,1,211,41 
DATA 254,141,1,211,169,192,133 
DATA 206, 169, 64,133,204, 177,203 
DATA 145,205,200,208,249,230,204 
DATA 230,206, 240,12,165, 206, 201 
DATA 208,208,237,169,216,133,206 
DATA 208,231,104,141,14,212,40 
DATA 104,96 


You can make this into a machine language AUTORUN.SYS file 
by changing the loop to 1634, removing the number 104 in line 
440, and deleting the USR call in line 220. Go to DOS and do a 
binary save (Option K) at addresses $600-$662, with a run ad¬ 
dress of $600. This will change your ROM OS into a RAM OS ev- 
ery time you boot up that disk. Pressing RESET switches the OS 
back to ROM. The machine language source code for this short 
program (also by Joe Miller) is included here because I feit it 
important for machine language programmers to see how this 
is done: 

; Move XL OS ROM into RAM 

;RAMROM—Installs the XL ROM-based 
; OS In RAM at the same address 
; space. This is useful For 
; making small patches To the 
; OS Or For experimenting With 
; New design concepts, such As 
; multitasking, window 
; management, etc. 


By Joe Miller. 


;This Version is configured 
; As an AUTORUN.SYS file. 


SOURCE 

EQU 

$CB 

DEST 

EQU 

SOURCE+2 

START 

EQU 

$0600 

OS ROM 

EQU 

$C000 

OSRAM 

EQU 

$4000 

NMIEN 

EQU 

$D40E 

PORTB 

EQU 

$D301 


;zero page usage 

;START address 

;address of OS ROM Start 

;address of ROM 

destination 

;NMI enable register 

;memory mgt control 

latch 
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Passl 


Swap 


Pass2 


Enable 


ORG 

START 


LDA 

#1ow OSROM 


STA 

SOURCE 


STA 

DEST 

;initialize copy addrs 

LDA 

#high OSROM 


STA 

SOURCE+1 


LDA 

#high OSRAM 


STA 

DEST+1 


LDY 

#0 


LDA 

(SOURCE),Y 

;Repeat 

;copy ROM To RAM 

STA 

(DEST),Y 


INY 

BNE 

Passl 


INC 

DEST+1 


INC 

SOURCE+1 


BEQ 

Swap 

; If done 

LDA 

SOURCE+1 


CMP 

#$D0 


BNE 

Passl 

;skip 2K block at $D000 

LDA 

#$D8 


STA 

SOURCE+1 


BNE 

Passl 

; Until SOURCE = $0000 

PHP 


;save processor Status 

SEI 


;disable IRQs 

LDA 

NMIEN 


PHA 


;save NMIEN 

LDA 

#0 


STA 

NMIEN 

;disable NMIs 

LDA 

PORTB 


And 

#$FE 

;turn off ROMs 

STA 

PORTB 

;(leaving BASIC 

LDA 

#high OSROM 

unchanged!) 

STA 

DEST+1 

; Set up block copy 

LDA 

#high OSRAM 


STA 

SOURCE+1 


LDA 

(SOURCE),Y 

;Repeat 

;move RAM OS To proper 

STA 

(DEST),Y 

address 

INY 

BNE 

Pass2 


INC 

SOURCE+1 

;move To Next page 

INC 

DEST+1 


BEQ 

Enable 

; If complete 

LDA 

DEST+1 


CMP 

#$D0 


BNE 

Pass2 

;skip block at $D000 

LDA 

#$D8 


STA 

DEST+1 


BNE 

Pass2 

; Until DEST = $000 

PLA 

STA 

NMIEN 

;reestablish NMI mask 

PLP 


;reenable IRQs 

RTS 

End 

START 



A sophisticated program called "RamMaster," by Matt Ratcliff, 
is available free through the Gateway BBS in St. Louis, Missouri. 

It not only creates a RAM OS, but it has a trap to keep the OS as 
RAM even when you press RESET. It also allows you to switch 
BASIC in and out from DOS. Probably the most elegant solution 
is the XL BOSS board which allows you to switch in a RAM OS, 
the older 800 OS, and the XL OS, as well as turn BASIC on or off 
with a few keypresses. It's available from Allen MacroWare in 
Redondo Beach, California. 

When you change the OS ROM into RAM, you can change all 
but a small portion of the OS at 53248-55295 ($D000-$D7FF), 
since it's RAM. You could always write an OS, load it into RAM, 
disable the ROM, and load yours in. You can change the 
character sets in their original locations rather than having to 
move them and use more memory. You could rewrite the han- 


Converted and layouted 2006 by Andreas Bertelmann for ABBUC 







Appendix 12 - XL/XE Memory Map 


204 

■ 


dlers, interrupts, and other routines-almost anything. 

This is exactly what the Translator disk does when it writes the 
800 OS into the XL. Boot the Translator and place a regulär DOS 
disk in at the prompt so that BASIC READY comes up. Now type: 

10 For N=57344 To 57351 
20 Read A:POKE N,A: Next N 
30 DATA 255,1, 1,1,1,1,1,1 

You'll see a "graph pad" screen: You've POKEd directly into 
the character set at $E000, altering the first character (space). 
This also means that the area from 49152 to 52991 ($C000 to 
$CEFF) isn't used-almost 4K of free RAM for player missiles, 
machine language routines, anything you need it for. Be care- 
ful not to run over into the interrupt handlers at 52992 ($CF00). 

54019 D303 PBCTL 

The PORT B Controller on the 400/800; not used since there isn't 
one on the XL/XE series. 

54528-54783 D500-D5FF 

Unused in both XL and 400/800 models. Any access read or 
write to this area enables the cartridge control line CCNTL as in 
the cartridge interface in the 400/800. 

55296-57343 D800-DFFF FP 

Floating-point package; although corrected, the entry point re- 
mains the same as in the 400/800. You now get an error if you 
try to get a LOG or LOG 10 of 0. This area becomes addressable 
by the device when the OS switches out ROM to perform I/O on 
a device connected to the expansion slot. 

There are several tables built into the FP package: 

Address Table 

56909/DE4D Power of 10 coefficients 
57202/DF72 Logarithm coefficients 
57262/DFAE Arctangent coefficients (unused?) 

The OS switches the floating point out and switches in the par¬ 
allel bus interface (PBI) ROM when an external device attached 
through the bus is selected, switching it back when the I/O is 
completed. This means an external device can't use floating 
point or any Software which does (such as BASIC). 


The first 26 bytes of the hardware ROM vector area (when OS 
ROM is deselected) are: 


Byte 

Hex 

Use 

55296/55297 

D800/D801 

ROM checksum LSB/MSB (Optional ) 

55298 

D802 

ROM revision number (Optional ) 

55299 

D803 

ID number (128; $80) 

55300 

D804 

Device Type (Optional) 

55301 

D805 

JMP instruction ($4C) 

55302/55303 

D806/D807 

I/O vector LSB/MSB 

55304 

D808 

JMP 

55305/55306 

D809/D80A 

Interrupt vector LSB/MSB 

55307 

D80B 

ID number (145; $91) 

55308 

D80C 

Device name In ASCII (Optional) 

55309/55310 

D80D/D80E 

Open vector LSB-l/MSB 

55311/55312 

D80F/D810 

Close vector LSB-l/MSB 

55313/55314 

D811/D812 

Get Byte LSB-l/MSB 

55315/55316 

D813/D814 

Put Byte LSB-l/MSB 

55317/55318 

D815/D816 

Status vector LSB-l/MSB 

55319/55320 

D817/D818 

Special vector LSB-l/MSB 

55321 

D819 

JMP 

55322/55323 

D81A/D81B 

Init vector LSB/MSB 

55324 

D81C 

Unused 
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On a cold Start, the OS polls for parallel devices, and if it finds 
one, JMPs (through 55321; $D819) to the INIT routine at 
55322/55323 ($D81 A, $D81 B) which places the address of the ge- 
neric parallel device handler into the handler tables with the 
device name. 

57344-58367 E000-E3FF CHARSET1 

Standard (domestic) character set; default on power-up or RE¬ 
SET; pointed to by 756 (S2F4). 

58368-65535 E400-FFFF OS 

The OS has been considerably rewritten and changed since the 
400/800. The ANTIC, PIA, and POKEY Chips are the same, but 
many OS routines have been moved. The vectors in RAM have 
remained in place for the most part, so Software which avails it- 
self of these locations can run on all machines, Always use the 
vectors when writing Software to use OS routines, never the ac- 
tual routines themselves; they may change, while the vectors 
will not. 

Locations 58368-58495 ($E400-$E47F) still contain the vector ta¬ 
bles. but point to different locations than the 400/800 (for more 
information, refer back to the 400/800 section). The vectors (ex- 
cept JMP) all point to the address of the routine minus 1: 


Device & Loc 

Open 

Close 

Get 

Put 

Status 

Special 

JMP To 

E 

58368 $E400 

EF93 

F2D2 

F249 

F2AF 

F21D 

F2C2 

EF6E 

S 

58384 $E410 

EF8D 

F2D2 

F17F 

Fl A3 

F21D 

F9AE 

EF6E 

K 

58400 SE420 

F21D 

F21D 

F2FC 

F22C 

F21D 

F22C 

EF6E 

P 

58416 $E430 

FEC1 

FF0 6 

FEC0 

FECA 

FEA2 

FEC0 

FE99 

C 

58432 $E440 

FCE5 

FDCE 

FD7 9 

FDB3 

FDCB 

FCE4 

FCDB 


The JMP vectors in locations 58448-58583 ($E450-$E4D7) remain 
the same, but point to new vector addresses: 


Label 

Loc 

JMP To 

DISKIV 

E450 

C6A3 

DISKINV 

E453 

C6B3 

CIOV 

E45 6 

E4DF 

SIOV 

E45 9 

C933 

SETBV 

E45C 

C272 

SYSBV 

E45F 

C0E2 

XITBV 

E462 

C28A 

SIOINV 

E465 

E95C 

SENDEV 

E468 

EC17 

INTINV 

E46B 

cooc 

CIOINV 

E46E 

E4C1 

SELFSV 

E471 

F223 (used To be BLKBVD) 

WARMSV 

E474 

C290 

COLDSV 

E477 

C2C8 

RBLOKV 

E47A 

FD8D 

CSOPIV 

E47D 

FCF7 

Several of 

these locations themselves are JMP 


routines, done to maintain compatibility with the older 800 OS. 


Some new fixed entry point vectors have been added: 


58496/E480 

58499/E483 

58502/E486 

58505/E489 

58508/E48C 


PUPDIV: Entry To power-On display (self-test 
mode In all XL/XEs except 1200XL; Atari 
logo screen display In the 1200XL). Try 
X=USR(58496). Points To 61987 ($F223). 

SLFTSV: 1200XL only: entry To self-test mode. 
Points To 20480 ($5000) (see PORTB above). 
PENTV: Entry To the handler uploaded from 
peripheral Or disk. Points To 61116 ($EEBC). 
PHUNLV: Entry To uploaded handler unlink. 
Points To 59669 ($E915). 

PHINIV: Entry To uploaded handler initializa- 
tion. Points To 59544 ($E898). 
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58481 E471 SELFTST 

Entry into the self-test mode by typing BYE in BASIC or X = 
USR(58481). This used to be the blackboard (Memo Pad) 
mode--a feature parents used to entertain their children, while 
keeping them from actually tinkering with the System or pro- 
grams. In the 1200XL, this is the location of the logo screen. I 
miss the blackboard mode myself; the self-test isn't really all 
that useful. There is no equivalent mode to blackboard in the 
XL/XE System. 

58511 E48F GPDVV 

Generic parallel device handler general-purpose vector. You 
can use this to talk to any expansion port device; move this ad¬ 
dress into FIATABS (794-831; $31A-$33F) along with an appro- 
priate device name such as V: or TSee the appendix on the 
expansion bus. There are seven vectors in this table, 
corresponding to the vector tables at 58348 ($E400). 

58528-58560 E4A0-E4C0 .... 

Blank area (all zeros). 

58561 E4C1 ICIO 

Initialize CIO. 

58588 E4DC IIN 

IOCB not OPEN error routine. 


58591 E4DF CIO 

The CIO area includes the following routines: 


Address 

58640/E510 

58645/E515 

58650/E51A 

58687/E53F 

58716/E55C 

58742/E576 

58748/E57C 

58775/E597 

58802/E5B2 

58910/E610 

58992/E670 

58994/E672 

59029/E695 

59067/E6BB 

59080/E6C8 

59089/E6D1 

59096/E6D8 

59114/E6EA 

59124/E6F4 

59135/E6FF 

59158/E716 


Routine 

Nonexistent device Error 

Load peripheral handler For Open 

Perform CIO command 

Execute Open command 

Initialize IOCB For Open 

Poll peripheral For Open 

Execute Close command 

Execute STATUS And SPECIAL commands 

Execute Get command 

Execute PUT command 

Set Status 

Complete CIO Operation 
Compute handler entry point 
Decrement buffer length 
Decrement buffer pointer 
Increment buffer pointer 
Set final buffer length 
Execute handler command 
Invoke device handler 
Search handler table 
Find device handler 


59193 E739 PHR 

Peripheral handler loader. Includes the following routines: 


Address 
59193/E739 
5932 6/E7BE 
59358/E7DE 
59414/E816 
59443/E833 
59485/E85D 
59540/E894 
59544/E898 
59550/E89E 
59584/E8C0 
59648/E900 
59669/E915 


Routine 

Initialization 

Perform poll 

Load handler 

Get Byte routine 

Get Next load block 

Search handler Chain 

Handler warm Start initialization 

Warm Start initialization With chaining 

Cold Start initialization 

Initialize handler And update MEMLO 

Initialize handler 

Handler unlinking 
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59740 E95C SIO 

The SIO section includes the following routines: 


Address 

59740/E95C 

59761/E971 

59946/EA2A 

59959/EA37 

60040/EA88 

60077/EAAD 

60140/EAEC 

60157/EAFD 

60199/EB27 

60204/EB2C 

602 95/EB87 

60317/EB9D 

60433/EC11 

60439/EC17 

60480/EC40 

60502/EC56 

60548/EC84 

60570/EC9A 

60585/ECA9 

60591/ECAF 

60608/ECC0 

60616/ECC8 

60718/ED2E 

60733/ED3D 

60871/EDC7 

60898/EDE2 


Routine 

Initialization 
SIO main routine 
Complete SIO Operation 
Wait For completion Or ACK 
Send buffer To serial bus 
Process serial Output ready IRQ 
Process serial Output complete 
Receive 

Indicate timeout 

Process serial Input ready IRQ 

Set buffer pointers 

Process cassette I/O 

Timer expiration 

Enable SIO send 

Enable SIO receive 

Set For send Or receive 

Disable send Or receive 

Get device timeout 

Table of SIO interrupt handlers (six bytes) 

Send To intelligent device 

Set timer And wait 

Compute baud rate 

Adjust VCOUNT value 

Set initial baud rate 

Process BREAK key 

Set SIO VBLANK parameters 


60921 EDF9 TPFV 

Table of POKEY frequency values (24 bytes). 


60945 EE11 NTSC/PAL 
Table of constant values. 


60957 EE1D Tables 

Screen memory and display list tables. 


Address 

60957/EE1D 

60973/EE2D 

61005/EE4D 

61021/EE5D 

61037/EE6D 

61053/EE7D 

61069/EE8D 

61085/EE9D 

61101/EEAD 


Table 

Screen memory allocation 
Display list entry counts 
ANTIC graphics modes 
Display list vulnerability 
Left shift columns 
Mode column counts 
Mode row counts 
Right shift counts 
Display masks 


61116 EEBC PHE 

Peripheral handler entry, includes the following routines: 


Address 

61177/EEF9 

61222/EF26 


Routine 

PH poll at Open 

Put-Byte routine For provisionally Open IOCB 


61294 EF6E SIN 

Initialize screen routine. Includes other screen handler routines: 


Address 

6132 6/EF8E 

61332/EF94 

61340/EF9C 

61824/F180 

61839/F18F 

61860/F184 

61828/F184 

61898/F1CA 

61929/F1E9 

61960/F208 

61982/F21E 

61997/F22D 

61998/F22E 


Routine 

Perform screen Open 
Perform editor Open 
Complete Open command 
Screen Get-Byte routine 
Get data under Cursor 
Screen put-Byte routine 
Check End of Line 
Plot point 
Display 

Set Exit conditions 
Screen STATUS 

Screen editor SPECIAL (just RTS) 
Screen editor Close 
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62026/F24A 

62128/F2B0 

62142/F2BE 


Editor Get-Byte (see below) 
Editor put-Byte (see below) 
Process character 


62026 F24A GETCHAR 

New location for the "get character" routine (used to be at 
63038). If you use the routines for screen display in Machine 
Language for Beginners, you'll have to change this address for 
proper XL Operation. 


62128 F2B0 OUTCHAR 

New location for the "put character" routine. See the note in 
62026. Several programs make use of an illegal call to the "get 
character" and "put character" routines, previously at 63038 
and 63140 ($F63E and F6A4), now at locations 62026 and 62128 
($F24A and $F2B0), respectively. You may be able to correct 
some problems in your Software by searching for and replac- 
ing the older vectors with the new locations. 


62200 F2F8 IGN 

Ignore character and do keyboard get-byte. 


62205 F2FD KGB 

Keyboard GET-BYTE routine. The keyboard handler follows and 
includes the following routines: 


Address 

62432/F3E0 

62438/F3E6 

62451/F3F3 

62464/F400 

62474/F40A 

6247 6/F40C 

62481/F411 

62491/F41B 

62496/F420 

62528/F440 

62586/F47A 

62613/F495 

62618/F49A 

62623/F49F 

62677/F4D5 

62732/F50C 

62752/F52D 

62806/F556 

62815/F55F 

62821/F565 

62825/F569 

62840/F578 

62880/F5A0 

62892/F5AC 

62986/F60A 

63073/F661 

63077/F665 

63150/F6AE 

63164/F6BC 

63256/F718 


Routine 

Escape character handler 

Move Cursor up 

Move Cursor down 

Move Cursor left 

Move Cursor To right margin 

Set Cursor column 

Move Cursor point 

Move Cursor To left margin 

Clear screen 

Move Cursor home (upper-left corner) 

Tab character handler 

Set Tab 

Clear Tab 

Insert character 

Delete character 

Insert Line 

Delete Line 

Sound bell 

Cursor To bottom 

Double-Byte Double decrement 

Store data For fine scrolling 

Double-Byte Single decrement 

Set scrolling display list entry 

Convert Cursor row/column To address 

Advance Cursor routines 

Return With scrolling 

Return 

Subtract End point 

Check Cursor ränge routines 

Restore old data under Cursor 


63267 F723 BMI 

Bitmap routines for the editor and screen handler. 


63479 F7F7 SCR 
Screen scroll routines. 


63665 F8B1 CBC 

Buffer count computation routines; various keyboard, editor, 
and screen follow, including: 

Address Routine 

63768/F918 Delete Line 
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63804/F93C 

63820/F94C 

63831/F957 

63842/F962 

63875/F983 

63895/F997 

63910/F9A6 

63919/F9AF 


Check For control character 
Save row And column values 
Restore row And column 

Swap Cursor With regulär Cursor position 

Sound key click 

Set Cursor at left edge 

Set memory scan counter address 

Perform screen SPECIAL command 


64260 FB04 TMSK 

Various screen and keyboard tables begin here: 


Address 

64260/FB04 

64264/FB08 

64269/FBOD 


64317/FB3D 

64329/FB49 

64333/FB4D 

64337/FB51 

64529/FC11 


Table 
Bit masks 

Default screen colors (PFO-3, BAK) 

Control character routines (Each entry is 
three bytes; control character And two-Byte 
address of Processing routine) 

Shifted Function key routines (1200XL) 
ATASCII To internal conversion constants 
Internal To ATASCII conversion constants 
Keyboard definition (see below) 

Function key definitions 


64337 FB51 

Start of the 192-byte keyboard definition table; see location 121, 
122 ($79, $7A). 


64537 FC19 KIR 

Keyboard IRQ Processing routines; check and process charac¬ 
ter, CONTROL-1, HELP key, CONTROL and function keys (1200XL; 
although the code for function keys remains in the 800XL and 
XE series) 


64708 FCC4 FDL 

Process display list interrupt for fine scrolling. 


64728 FCD8 CIN 

Cassette initialization routine, followed by cassette I/O routines 
and table of NTSC/PAL constants for file leader length and 
beep duration. 


65177 FE99 PIN 

Printer initialization and I/O routines including: 


Address 

65218/FEC2 
65227/FECB 
65261/FEED 
65270/FEF6 
65287/FF07 
65300/FF17 
65348/FF44 
65355/FF 4B 


Routine 

Printer Open 
Printer put-Byte 
Fill printer buffer 
Perform printer put 
Printer Close 
Set up DCB For printer 
Printer timeout from STATUS 
Process Print mode 


65395 FF73 VFR 

ROM checksum verify routines for first 8K bank. 


65426 FF92 VSR 

Verify routines for ROM checksum, second 8K bank, including 
routines to examine checksum region and table of addresses to 
verify. 


65518-65529 FFEE-FFF9 .... 

Checksum and identification data for the ROM area 
57344-65535 ($E000-$FFFF~see 49152, $C000 for more 
information): 
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Byte 

65518/FFEE 

65519/FFEF 

65520/FFF0 

65521/FFF1 

65522-26/FFF2-6 

65527/FFF7 

65528-9/FFF8-9 


Use 

Revision Date Dl And D2 (four-bit BCD) 
Revision Date Ml And M2 
Revision Date Y1 And Y2 
Option Byte; should Read 1 For the 
1200XL (my 800XL reads 2) 

Part number In the form AANNNNNN 
Revision number (again, mine reads 2) 
Checksum, bytes (LSB/MSB) 


65527 and 65528 should read 221 ($DD) and 87 ($57) for the 
400/800 revision A ROMS; 243 ($F3) and 230 ($E6) for the B 
ROMS. PAL versions read 214/87 ($D6/$57) and 34/88 ($22/$58), 
respectively. The 1200XL should read 10 at 65527 for revision A 
and 11 for revision B. The 600XL should read 1 at 65527, and the 
800XL, 2. For the 1200XL, 64728 ($FCD8) should not read 162 
($A2). 

65530-65535 FFFA-FFFF Machine vectors 

Contain NMI, RESET (power-up), and IRQ Service vectors, initial- 
ized to 49176 ($C0I8), 49834 ($C2AA), and 49196 ($C02C), 
respectively. 
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17 Appendix 13 - XL/XE Enhancements and Bugs 

First the Good News 

The XL Computers fixed several bugs in the 400/800 and added many enhancements including 
relocatable handlers, new poll and new graphics modes in BASIC. 

Now, the OS inserts an end of line (EOL) character in the printer butter if there isn't one already 
there when you CLOSE the device. You don't have to force out the last characters in the butter. 
Printer numbers PI through P8 are also accessible now. 

When reading either a record that's too long or one truncated with an end of file (EOF), the OS 
inserts an EOL into the input butter to pro- vide at least as much as the butter can handle without 
an error, so data isn't lost. 

The screen will clear no matter what the Cursor Coordinates. The dis- play handler and screen 
editor no longer clear memory above RAMTOP, so any data such as player/missile graphics you 
have up there is protected, even when changing graphics modes. 

The cassette loading mechanics have been greatly improved by a change in timing values (see the 
XL manual for details). 

Now the Bad News 

The Revision B BASIC ROMs have several awesome bugs in them, pointed out to me by Matt 
Ratclitt (a fountain of knowledge about the XL) on the Gateway BBS, St. Louis, Missouri. If you 
PEEK(43234) and get 96, you have the bug-ridden B ROMs; write to Atari and ask them for a new 
C ROM cartridge. 

Here are some of the bugs Matt described: First, BASIC appends 16 useless bytes to the end of a 
file on saving. This is a cumulative pro- cess; each time you load and save the same program, 
another 16 bytes are appended. This can cause severe problems and errors like 164-truncated 
record. Make sure you have nothing good on your disk and try this: 

10 Print FRE(0): SAVE "D:JUNK”:RUN "D:JUNK" 

and watch your memory dwindle away, 16 bytes at a time! Eventually, your System will crash. 

Now try this: Type CSAVE (even it you don't have a cassette) and turn up your TV volume-press 
RETURN after the beeps and listen; you’ll hear the CSAVE tones. When the READY prompt 
reappears, turn the volume up even more. Hear that? It's the sound of the load still on! You'll have 
to type END or SOUND 0,0,0,0 to get rid of it. CLOAD has the same problem. This is a bug in both 
versions. not just the B ROMs. 

Another problem is the unaccountable error 9—String not DIMed- occurring on the line where the 
DIM Statement actually resides! When you do too many loads and saves, especially with files 16K 
or larger, your System will lock up. Don't fool around; get the new ROM, which is available on 
cartridge, Write to Atari Customer Relations, 390 Caribbean Drive, Sunnyvale, California 94088. 
(See Appendix 19 for a temporary fix.) 

The 65XE and 130XE use the Revision C ROMs, so you don't have to worry about these bugs. XL 
owners can type in Matts program from Appendix 19 to eure their woes until they get the proper 
Chips or cartridge. 
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18 Appendix 14 - XL/XE Parallel Bus 

The most exciting new feature on the XL Computers is probably the least heralded and the most 
unused: the parallel expansion bus port (PBI) on the back of the machines. It provides direct, 
unbuffered ac- cess to all of the address, data, and control lines, allowing the use of high-speed 
peripherals (fast parallel I/O disk drives, hard disks, and custom I/O devices). The April 1985 issue 
of Analog magazine has an article by Michael Barton on adding additional memory to his 600XL via 
the expansion port. Antic ran a special four-part series by Earl Rice on the bus from January to 
April 1985. The bus connector looks like this: 


Top 


Pin 

Pin 

Bottom 

Ground 

GND 

1 

2 

External Select 

Address Output 

A0 

3 

4 

Al 


A2 

5 

6 

A3 


A4 

7 

8 

A5 


A6 

9 

10 

GND 


Al 

11 

12 

A8 


A9 

13 

14 

A10 


All 

15 

16 

A12 


A13 

17 

18 

Al 4 


GND 

19 

20 

Al 5 

Data lines 

DO 

21 

22 

Dl 

(Bidirectional) 

D2 

23 

24 

D3 


D4 

25 

26 

D5 


D6 

27 

28 

D7 


GND 

29 

30 

GND 

Phase 2 clock Output 


31 

32 

GND 

Reserved 

NC 

33 

34 

Reset Output 

Interrupt request 

(IRQ) 

35 

36 

Ready Input 


NC 

37 

38 

External decoder 


NC 

39 

40 

Output 

Refresh Output 

Column address 

Output 


41 

42 

GND 

Math pack disable 

Input 


43 

44 

Row addr Strobe 


GND 

45 

46 

Latch Read/Write 

(+5v de?) 

NC 

47 

48 

out 

NC (+5v de?) 

Audio Input 


49 

50 

GND 


Looking at the bus from the back, it looks like this: 


TOP 

1 3 5 7 9 11 13 15 17 19 21 23 25 27 29 31 33 35 37 39 41 43 45 47 49 

+-+ 


+-+ 

2 4 6 8 10 12 14 16 18 20 22 24 26 28 30 32 34 36 38 40 42 44 46 48 50 

BOTTOM 


The expansion bus is a complex subject-enough for a whole book. Refer to Rice's articles which 
cover the bus in greater detail. The XE continues the parallel bus, but improves it with a clock line 
and built- in +/-5v de current, (Barton, in his article in Analog, says pins 47 and 48 are already 5v de 
on the XL bus.) 

Changes on the 130XE 

On the 130 XE, the parallel bus is called the enhanced cartridge interface--ECI--basically, a 14-pin 
extension to the cartridge slot which allows external devices to connect to the machine's address 
and data bus lines and to access the operating System Software and detect the internal state of the 
Computer, It is functionally similar to and software-compatible with the PBI described above, The 
pin uses for the cartridge and the extension are as follows: 

Present 30-pin cartridge connector 

Top side 
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Pin 

Place 

RD4 

A 

GND 

B 

A4-A9 

C-J 

A12 

K 

D3 

L 

D7 

M 

All 

N 

A10 

P 

R/W 

R 

PH12 

S 

Bottom 

side 

Pin 

Place 

S4 

1 

A3 

2 

A2 

3 

Al 

4 

A0 

5 

D4 

6 

D5 

7 

D2 

8 

Dl 

9 

DO 

10 

D6 

11 

S5 

12 

+5v 

13 

RD5 

14 

CCTL 

15 


Description 
ROM present 
Ground 

Address lines 
Address Line 
Data Line 
Data Line 
Address Line 
Address Line 

Processor Read/Write Line 
System clock Line 


Description 

Chip Select Line —$8000 To $9FFF 
(right slot address On the 800) 
Address Line 
Address Line 
Address Line 
Address Line 
Data Line 
Data Line 
Data Line 
Data Line 
Data Line 
Data Line 

Chip Select Line —$A000 To $BFFF 
(left slot address On the 800) 

DC power supply 
ROM present 

ROM bank control selection Line 


Looking at the cartridge slot from the back, the pins are as follows: 


ABCDEFHJKLMNPRS 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 


i. 

S4 

A. 

RD4 

2 . 

A3 

B. 

GND 

3. 

A2 

C. 

A4 

4 . 

Al 

D. 

A5 

5. 

A0 

E. 

A6 

6. 

D4 

F. 

Al 

7 . 

D5 

H. 

A9 

8. 

D2 

J. 

A9 

9. 

Dl 

K. 

Al 2 

10. 

DO 

L. 

D3 

11. 

D6 

M. 

D7 

12 . 

S5 

N. 

All 

13. 

+5v 

P . 

A10 

14 . 

RD5 

R. 

R/W 

15. 

CCTL 

S . 

B02 


14-pin extension 


Top side 

Pin Place 

Res A 

IRQ B 

HALT C 

A13-15 D-F 

GND H 

Bottom side 

Pin Place 

EXSEL 1 

RST 2 

Dlxx 3 

MPD 4 

AUDIO 
REF 6 


Description 

Reserved 

Interrupt request Line 
ANTIC halt signal 
Upper three address lines 
Ground 


Description 

External device Select? 

System RESET 

Chip Select at area $Dlxx 
Math pack (FP) disable 
5 External audio Input 

Present cycle is a refresh cycle Line 


Converted and layouted 2006 by Andreas Bertelmann for ABBUC 











Appendix 14 - XL/XE Parallel Bus 


216 

’ 


+5v 7 Second de power supply 

Looking at the extension from the back, we see: 

A B C D E F H 
+-+ 


+-+ 

1 2 3 4 5 6 7 


A. 

Reserved 

i. 

EXSEL 

B. 

IRQ 

2 . 

RST 

C. 

HALT 

3. 

D1XX 

D. 

A13 

4 . 

MPD 

E. 

Al 4 

5 . 

Audio 

F. 

Al 5 

6. 

REF 

H. 

GND 

7 . 

+ 5v 


Atari 65XE 

There is no parallel bus on the 65XE; it was dropped by Atari since third-party manufacturers had 
not taken advantage of it. 
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The new graphics modes are 12, 13, 14, and 15 in BASIC; ANTIC modes 4, 5, 12 ($C), and 14 
($E), respectively. These have always been available internally, but BASIC programmers had to 
trick the OS to get at them. 

GRAPHICS 12 is a four-color text mode (plus background). Each character on the screen is the 
same height as a GRAPHICS 0 charac- ter (8 scan lines), but only tour pixels get displayed instead 
of eight. The screen has 20 lines (24 with GRAPHICS 12 + 16) and 4 lines of text, using 40 bytes 
of RAM per screen line. 

GRAPHICS 13 is another four-color text mode (plus background), but this time the characters are 
double the size of GRAPHICS 0 characters (16 scan lines high), while only four pixels are 
displayed (the System interprets the character set by bit pairs rather than single bits; see below). 
The screen has 10 lines (12 with GRAPHICS 13 + 16), also using 40 bytes per screen line. 

Since both GRAPHICS 12 and 13 display only four bits in each line of character definition, the color 
of the pixel displayed depends on the bit pair in the byte being addressed: 

Bit Pair Color RAM Location 
00 BAK 712 

01 PF0 708 

10 PF1 709 

11 This depends On bit 7 of the byte. 

If bit 7=0, Then use PF2 (at 710), 

Else use PF 3 (at 711). 


Note that each line in a character set definition (eight lines, one byte wide, form one character) can 
have different color combinations. Since bit pairs (one color clock) are displayed, the normal 
character set becomes unrecognizable. In order to use these modes, you should build a character 
set in which each character is half a letter and can be combined for display. Or build a 7 X 7 
character set with a blank row and column between each character. 

The characters displayed are not the full character set. They are only one half of the ATASCII set, 
depending on the value in location 756 ($2F4): 224 ($E0) for uppercase, 226 ($E2) for lowercase. 
When using GET or PUT operations in these modes, the lower seven bits (0-6) are used for 
character data (allowing a ränge from 0 to 127; $7F), while the high bit is the color modifier (see 
the table above). 

GRAPHICS 14 is a two-color mode with a resolution of 160 pixels wide (half the horizontal distance 
of GRAPHICS 8) and 192 high (160 with text lines). Each screen line is one scan line high, 
compared with GRAPHICS 6 where each line is two scan lines (GRAPHICS 14 is sometimes 
called GRAPHICS 6-1/2). BAK and PF0 are the two-color registers; the first bit of a screen byte 
identifies the color. 

GRAPHICS 15 has been made populär by many drawing and paint- ing programs such as 
Datasoft's Micropainter and both Koala's and Atari's drawing programs for their touch tablets, It is a 
four-color mode with a resolution of 160 across X 192 down (160 with text lines), each screen line 
being one scan line high. Colors are BAK, PF0-PF2; only the first two bits of a screen byte identify 
the byte color. It is sometimes called GRAPHICS 7-1/2. 


Memory Used 


Mode 

Lines 

Colors 

Split Screen 

Full Screen 

12 

40 X 20/24 

5 

1154 

1152 

13 

40 X 10/12 

5 

664 

660 

14 

160 X 160/192 

2 

4270 

4296 

15 

160 X 160/192 

4 

8112 

8138 


Here are the pinouts on the 800 and XL/XE's monitor jack (looking at the back of the unit): 


Converted and layouted 2006 by Andreas Bertelmann for ABBUC 









219 Mapping the Atari 



* * 



* 

* * 

* 


~k 

~k ~k ★ ~k ~k 'k k 

* 


* 


* 


Audia Output * 3 


1 * Composite 

luminance 

* 


* 


Composite chroma * 5 

(Not available * 

On XL models) * 

2 

Ground 

4 * Composite 

k 

video 
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Memory Management On The 130XE 

The bank select location is 54017 ($D301). PORTB, now an output rather than the input byte it was 
on the 400/800 machines, uses bits 2-5 (corresponding to pins 2-5 on the PIA 6520 Chip) to select 
which 16K bank is being accessed and whether or not the area is used for Video (ANTIC) access 
or 6502 access. There is another 64K of RAM in the 130XE (not the 65XE) which is identical to the 
main bank in layout and control, but it can be accessed only in 16K banks at any one time. Of 
course, using a fast interrupt driven ML routine, you can change bits in PORTB to shunt between 
16K banks as necessary. 

When a bank is enabled for access, it appears through an "access window" in the main memory, at 
locations 16384-32767 ($4000-$7FFF, below the OS ROM or cartridge areas). If you enable bank 
switching, you cause the normal RAM in this area to be replaced by the bank you've chosen. Bit 4 
is the CPU Bank Enable bit-CBE-and bit 5 is the Video Bank Enable bit--VBE. Bits 3 and 2 are 
the MSB and LSB of the secondary bank address, respectively. 

You can configure the System to one of four modes: compatible with existing XL/XE Software, CPU 
extended RAM, Video extended RAM, and general extended RAM modes. In all cases, only the 
area in the access window is affected by the mode selection. 

No synchronization between areas is required by the programmer; the System will know where the 
display area is by the bit settings in PORTB. This is important: Once you set the bits, you don't 
have to worry about where the access will occur; the OS takes over and se- lects the right bank. If 
you intend to make use of more than one 16K block in the extended RAM, you'll have to set and 
reset the bank selection bits as necessary, but not the CPE or VBE bits. 

In CPU extended RAM mode, only the CPU accesses the extra memory. All ANTIC cycles operate 
in the main 64K memory. This means you can use the extended memory for programs and data, 
while using the main bank for display lists and screen data. 

In the Video extended RAM mode, all ANTIC references to the area $4000-$7FFF will be directed 
to the secondary bank; all CPU references will occur in the main bank. This allows programmers to 
access the entire RAM memory for programs and data in the main area, while locating display lists 
and screen data in the secondary bank. 

In the extended RAM mode, both the CPU and ANTIC process in the second bank, exactly as if it 
were the main bank in compatibility mode (which is then not accessed at all). The normal state of 
the bits for either CPE or VBE is 1; secondary bank disabled. When set to 0, the access to the 
second bank is enabled. Here are the possible bit contigurations (M Stands for main bank, E for 
extended or secondary bank): 

Compatibility mode (only main bank enabled) 


Bit 

5 

Bit 

4 

Bit 3 

Bit 2 

CPU accesses: 

ANTIC accesses 

VBE 


CPE 


Bank 

selection 





1 


1 


doesn't matter 

M 

$4000-$7FFF 

M 

$4000-$7FFF 

CPU 

extended RAM mode 






Bit 

5 

Bit 

4 

Bit 3 

Bit 2 

CPU accesses: 

ANTIC accesses 

VBE 


CPE 


Bank 

selection 





1 


0 


0 

0 

E 

$0000-$3FFF 

M 

$4000-$7FFF 

1 


0 


0 

1 

E 

$4000-$7FFF 

M 

$4000-$7FFF 

1 


0 


1 

0 

E 

$8000-$BFFF 

M 

$4000-$7FFF 

1 


0 


1 

1 

E 

$C000-$FFFF 

M 

$4000-$7FFF 

Video 

(ANTIC) 

extended RAM mode 





Bit 

5 

Bit 

4 

Bit 3 

Bit 2 

CPU accesses: 

ANTIC accesses 

VBE 


CPE 


Bank 

selection 





0 


1 


0 

0 

M 

$4000-$7FFF 

E 

$0000-$3FFF 

0 


1 


0 

1 

M 

$4000-$7FFF 

E 

$4000-$7FFF 

0 


1 


1 

0 

M 

$4000-$7FFF 

B 

$8000-$BFFF 

0 


1 


1 

1 

M 

$4000-$7FFF 

E 

$C000-$FFFF 

General extended RAM 

Mode 





Bit 

5 

Bit 

4 

Bit 3 

Bit 2 

CPU accesses: 

ANTIC accesses 

VBE 


CPE 


Bank 

selection 





0 


0 


0 

0 

E 

$0000-$3FFF 

E 

$0000-$3FFF 
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0 0 0 
0 0 1 
0 0 1 


1 E $4000-$7FFF 
0 E $8000-$BFFF 
1 E $C000-$FFFF 


E $4000-$7FFF 
E $8000-$BFFF 
E $C000-$FFFF 


To Select which mode And bank you want To Access In BASIC, use 
POKE 54017, 193 + (MODE * 16) + (BANK * 4) 

For MODE And BANK, chose the number below which represents the Type And area at address: 


No. 

MODE 

6502 

ANTIC 

BANK 

No. 

Address 

0 

Extd 

Extd 

0 

$0000-$3FFF 

1 

Main 

Exd 

1 

$4000-$7FFF 

2 

Extd 

Main 

2 

$8000-$BFFF 

3 

Main 

Main 

3 

$C000-$FFFF 


Access to the extended memory is always through the bank $4000-$7FFF, so no matter what the 
address of the extended bank, you still PEEK and POKE at locations 16384-32767 ($4000-$7FFF), 
not the extended bank address. 

DOS 2.5 includes a program called RAMDISK.SYS which, when the disk is booted, checks to see 
if you have a 130XE and, if so, creates a 64K memory disk (RAMdisk) out of the extended 
memory. (See the section on DOS 2.5.) The RAMdisk occupies the entire 64K extended 
block, so you cannot use the extra 64K for BASIC or other programs if you want to keep the 
RAMdisk intact. 
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DOS 2.5 And The 1050 Drive 

The latest Version of DOS (Disk Operating System) for the XL and XE Computers is 2.5. It öfters 
several advantages over the earlier versions (including the ill-received DOS 3.0), including dual- 
density formatting, new XIO formatting commands available from BASIC, a RAMDISK program for 
the 130XE, and greater compatibility with DOS 2.0. If you use DOS 3.0,1 suggest you get a copy of 
2.5 as soon as you can. 

DOS 2.5 formats a track with 26 sectors instead of the 18 DOS 2.0 handles; this means a disk with 
1010 sectors free instead of 707 (leaving 931 free sectors with DOS and DUP.SYS files on a disk). 
The 1050 (not the 810) drive can automatically sense which density the disk in the drive is using. 
DOS 2.0 can read a 2.5 disk but the additional sectors are invisible to it. 

New BASIC Commands for DOS 2.5 

When you OPEN a disk from BASIC to get a directory read (see location 1792; $700 in the 
Addenda section), you normally use OPEN #1,6,0,"D:*.*." Now, if you use OPEN #1,7,0,"D:*.*," 
DOS will specify files which occupy disk sectors that can't be accessed by 2.0 with angle brackets, 
like <RAMROM.ASM>. These files are invisible to DOS 2.0 when reading a directory; they can't be 
loaded, nor do they show up in the directory. 

Formatting the disk by the XIO command is enhanced. The usual method is XIO 254, #1,0,0,"Dl 
This will format the disk, trying first for dual density, and if the drive doesn't Support it, formatting in 
single (2.0) density. XIO 253, #1,0,0,"Dlformats a disk with single density only (a new option-P- 
has been added to the DOS menu to format in single density as well). XIO 253, #1,34,0,"Dlwill 
format a disk in dual density only. 

RAMdisk for the 130XE 

DOS 2.5 includes a special program called RAMDISK.SYS. This loads up when the disk is booted 
and determines if your Computer is a 130XE. If so, it runs a small program which creates a "disk 
drive" out of the 64K extended memory bank. The RAMdisk acts just like a real disk, except that 
it's faster. It is formatted into 499 sectors and a directory and has the drive number D8:. DOS 2.5 
supports drives 1 -8, but is initialized to drives 1, 2, and 8, so if you have other drives, change 
location 1802 ($70A); that is, if you have three drives and the RAMdisk, POKE 1802, 135. All bits in 
location 1802 now represent possible drives. 

When it runs, RAMDISK.SYS copies MEM.SAV and DUPSYS to the RAMdisk, then modifies a 
location so that you call up DUP.SYS from the RAMdisk rather than Dl:. This brings up DOS 
almost immediately when you leave BASIC. However, if you want to delete DUP.SYS from the 
memory drive and call it up from drive 1 as usual, type POKE 5439, ASC("1"), this points DOS 
back to the original drive. You can also delete MEM.SAV from D8: if you don't need it. 

DOS 2.5 Boot Sector and Memory Map 

Locations 1792-1812 ($700-$714) are loaded directly into RAM from the boot sector (sector 1) on a 
disk. Refer back to the section in the 400/800 memory map tar more explanation. These are from 
an article by Neil Harris in the Atari Explorer; they are locations Atari promises to support in the 
future: 

1792 700 BFLG 

Boot flag; always equals 0. 

1793 701 BRCNT 

Number of sectors in the disk boot; three--the first three on the 
disk. 

1794,1795 702,703 BLDADDR 

Boot load address; where DOS is loaded into memory; always 
1792 ($700). 

1796,1797 704,705 BINTAD 

DOS initialization address; always 5440 ($1540). 
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1798-1800 706-708 BCONT 

JMP instruction to jump to the address where the boot program 
continues execution; 1812 ($714). 

1801 709 SABYTE 

Maximum number of concurrently open files-usually three. 

1802 70A DRVBYT 

Drive allocation byte; one bit per drive. 

1803 70B SAFBFW 

Unused. 

1804,1805 70C,70D SASA 

Buffer allocation address for drives and files. 

1806 70E DFSFLG 

Reads zero if there is no DOS.SYS on disk, nonzero if present. 

1807,1808 70F,710 DFLINK 

Points to first sector of the DOS.SYS file. 

1809 711 BLDISP 

Number of displacement bytes to sector link bytes (last three); 
always 125 ($7D). 

1810,1811 712,713 DFLADDR 

Address of the FMS (D:) handler table; 1995 ($7CB). 

1812 714 XBCONT 

Boot program begins here. 

1900 76C BSIO 

BASIC SIO routines. 

1906 772 BSIOR 

FMS disk handler routines. 

1913 779 

Write verify flag; 80 ($50) turns it off, 87 ($57) turns it on. 

1995 7CB DFMSDH 

FMS handler table. Has data in it different from 2.0 handler. 

2016 7E0 DINIT 

DOS initialization routine. 

4993 1381 FBC 

Start of the FMS file control blocks; first of eight. 

5121 1401 FILDIR 

128-byte buffer for a disk directory sector. 

5439 153F 

POKE with 49 (ASC('T')) to reroute DOS to call DUP.SYS from Dl: 
rather than D8: when using the RAMdisk-you can then delete 
DUP.SYS and MEM.SAV from the RAMdisk for extra space. See 
location 1923 ($783) in the Addenda. 

5440 1540 MINIDUP 

Start of permanently resident portion of DUP.SYS. 


Converted and layouted 2006 by Andreas Bertelmann for ABBUC 





Appendix 17 - DOS 2.5 226 

I 


5540 154A SFLOAD 

Entry to DUP.SYS's routine to load binary files. 

5542 15A6 ST LOAD 

Used with SFLOAD. 

5545 15A9 LOAD 

Used with SFLOAD. 
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Changing The 400/800 OS On The XL/XE Computers 

When you boot the Translator disk, use one of the commercial "fix" disks (such as FIXXL), or run 
Matt Ratcliff's "ROM OS to RAM OS" program (Appendix 19), you turn your OS from ROM based 
to RAM based. This allows you to change it by POKEing directly into memory. When you use the 
Translator or the Allen MacroWare XL BOSS Chip, you have the 400/800 operating System in 
memory instead of the XL/XE OS. 

This section describes many changes which can be made to the 400/800 OS when in the XL/XE 
RAM. In all cases, Revision B OS is described since the Translator and Allen MacroWare don't use 
the Revision A OS. These changes can be POKEd into memory if you have 
the Translator booted or the XL BOSS installed. For 400/800 owners, if you have the hardware for 
making your own PROMs or EPROMs, you can make these changes into the PROMs and replace 
them in your OS board. The same applies for the Newell Industries RamRod board. 

I have tested and used both the Newell RamRod and the Allen MacroWare XL BOSS and consider 
them both excellent products and highly recommend them. Much of the following material was 
derived from their manuals. 

57344 E000 CHARSET1 

You can change the character set directly by POKEing here 

rather than reserving space in memory for an altered set. See 
the section on character sets in the main memory map and 
54017 ($D301). (XL/XE users can change this and the inter¬ 
national set also.) 

59497 E869 

The interval for the keyboard repeat. The original value is 6; 

POKE with 3 to move the Cursor twice as fast for repeating 
characters (XL/XE also). 

60294 EB86 

To increase the cassette baud rate by almost one-third and re- 
duce the time of the leader from 20 to 10 seconds, POKE the 
following: 


POKE 

Address 

Value 

Hex 




60294 

00 

$EB84, 

$00 

low Byte, 

Write baud 

60299 

04 

$EB8B, 

$04 

high Byte 


61250 

00 

$EF42, 

$00 

low Byte, 
routine 

baud rate init 

61255 

04 

$EF47, 

$04 

high Byte 


61346 

00 

$EFA2, 

$00 

baud rate 

Open routine 

61351 

04 

$EFA7, 

$04 

high Byte 


61371 

02 

$EFBB, 

$02 

leader time 


61683-61707 F0F3-F10B 

Memo pad mode startup message; "ATARI COMPUTER - MEMO 
PAD (CR)." 

61709-61718 F10D-F116 .... 

BOOT ERROR message. This is at 50237 ($C43D) in the XL/XE. 

61812 Fl 74 

Left margin default; initially 2. 

61816 F178 

Right margin default; initially at the maximum 39 ($27). 
63227-63229 F6FB-F6FD 

Key click sound, change these three bytes to 234 ($EA) to dis- 
able the key click sound completely. 
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64728 FCD8 CLICK 

You can also remove the click sound by changing the first byte 
of the routine here to 96 ($60; RTS). 

64729 FCD9 

The buzzer/bell time for warning sound prompts. Initially 127 
($7F), you can reduce it to any time; 63($3F) is half the time. 

This location also affects the key click sound time. 

65217-65221 FEC1-FEC5 

Default (startup) color value tables. These values are moved to 
the shadow registers 708-712 ($2C5-$2C8) on power-up or RE¬ 
SET. The screen startup is blue; to change it to black, POKE 
65219 ($FEC3), 0. 

65278 FEFE 

The keyboard table; you can redefine the entire keyboard by 
POKEing here (see the XL/XE map section). One trick is to 
change the keyboard so that the Cursor (arrow) keys work on 
pressing, and you have to press SHIFT and arrow to get -, =, 

+, and *, and CONTROL and arrow to get <up arrow>, <down arrow>, 
cleft arrow>, and cright arrow>. Do 
this by: 


POKE 




Address 

Value 

Hex 


65284 

30 

$FF04, 

$ IE 

65285 

31 

$FF05, 

$ 1F 

65292 

28 

$FF0C, 

$1C 

65293 

29 

$FF0D, 

$ ID 

65348 

43 

$FF44, 

$2B 

65349 

42 

$FF45, 

$2A 

65356 

45 

$FF4C, 

$2D 

65357 

61 

$FF4D, 

$3D 

65412 

92 

$FF84, 

$5C 

65413 

94 

$FF85, 

$5E 

65420 

95 

$FF8C, 

$5F 

65421 

124 

$FF8D, 

$7C 


(XL/XE owners: Your keyboard definition table begins at 64337, 
so to use this modification, subtract 941 from the addresses 
given above.) 

65281 FF01 

1200XL owners: You can use your function keys as Cursor keys 
by POKE 65281,30 ($FF01 ,$1 E), POKE 65282, 31 ($FF02,$1 F), 
POKE 65297, 28 ($FF11, $1C) and POKE 65298, 11 ($FF12,$1 D). 

65487 FFCF 

XL/XE only: To make the HELP key a start/stop key equivalent to 
CONTROL-1, POKE here with 17 ($11). The HELP key returns a 
keycode value at 732 ($2DC) of 17 ($11) for normal use, 81 ($51) 
for SHIFT+HELP, and 145 ($91) for CONTROL+HELP. 

65507 FFE3 

The time delay for the repeat feature; initially 3; POKE with 1. 

See also 65516 (FFEC) below. 

65516 FFEC 

Key repeat delay. Initially 48 ($30); change to 15 ($0F). Do this 
in conjunction with the change at 65507 ($FFE3). 
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BASIC Software Toggle 

This is a Version of the BASIC switcher routine used in a public domain program called 
"RamMaster," available on the Gateway BBS, St. Louis, Missouri, used here with permission by its 
author, Matt Ratcliff. The program creates an AUTORUN.SYS file which prompts you to turn 
BASIC on and off; there's no need to hold down the OPTION key when booting a disk. When you 
turn it off from DOS, you gain the 8K RAM it occupies; DOS takes advantage of this memory space 
for copy and disk duplication routines. Refer back to the XL/XE memory map for more information. 


800XL BASIC Switcher 


10 GRAPHICS 0: Dim A$(10):? "800XL BASIC SWITCHER" 

15 Print "By Matthew Ratcliff 3/25/85" 

20 Print :Print "GET DOS DISK READY AND PRESS RTN;" 
25 Input A$ 

30 TRAP 200:Open #1,8, 0, "D:AUTORUN.SYS" 

40 RESTORE 

50 Read A:If A<0 Then 100 
60 PUT #1,A: GoTo 50 

100 Close #1: Print "BASIC SWITCHER READY." 

"PUT THIS FILE ON ALL YOUR 'BASIC'" 
"PROGRAMMING DISKS Print 
"SAVE THIS LOADER AS A BACKUP!" 


105 Print 
110 Print 
115 Print 
120 End 
200 Print 
210 Print 


"UNEXPECTED ERROR ";PEEK(195) 

"AT LINE ";PEEK(186)+256*PEEK(187):End 


1000 DATA 255,255, 0,52,236, 53,173,250, 3,240,1 

1005 DATA 96, 32,160,53, 76, 34,52, 184,176 

1010 DATA 176,216,204,160,194,193,211,201,195 

1015 DATA 160,211,247,233,244,227,232,229,242,155,4 

1020 DATA 162,12,160,52,32,120,53,76, 56, 52, 194 

1025 DATA 249,160,205,225,244,170,210,225,244 

1030 DATA 155,4, 162, 44, 160, 52,32,120, 53,76, 88 

1035 DATA 52, 80,114, 101,115, 115, 32,35,32 

1040 DATA 97,110,100,32,210,212,206,32,107,101 

1045 DATA 121,58, 155,4, 162, 66, 160,52,32,120 

1050 DATA 53,76, 115,52, 91,49, 93,32, 66, 65,83 

1055 DATA 73,67,32,160,207,206,160,160,155 

1060 DATA 4,162, 98,160, 52,32, 120, 53,76, 142,52, 91 

1065 DATA 50, 93, 32,66, 65, 83, 73, 67 

1070 DATA 32, 160,207, 198,198, 160, 155, 4, 162, 125 

1075 DATA 160,52,32,120,53,32,203,53,201,50 

1080 DATA 208,41,173,1,211,9,2,141,1,211,169 

1085 DATA 192,133,106,32,160,53,76,187,52 

1090 DATA 160,194, 193,211,201, 195, 160, 207,198 

1095 DATA 198,160,155,4,162,174,160,52,32,120,53 

1100 DATA 76, 62,53,201, 49, 240,3, 76,79, 53, 173, 1,211 

1105 DATA 41,253,141,1,211,169,160 

1110 DATA 133,106, 32,160,53, 76,235, 52, 160,194 

1115 DATA 193,211,201, 195,160,207,206, 160,29,155 

1120 DATA 4,162,222, 160,52,32, 120,53,173,226, 168 

1125 DATA 201, 96, 208,48,76, 31,53, 82, 69 

1130 DATA 86, 46, 66,32,45, 32, 195,239, 238,244,225, 227 

1135 DATA 244,160,193,212,193,210,201,160 

1140 DATA 230,239,242,160,210,197,214,174,195 

1145 DATA 160,161,155,4,162,252,160,52,32,120,53 

1150 DATA 76, 62,53,201,234,208, 17,76, 55, 53, 82, 69 

1155 DATA 86, 46, 67,155, 4, 162,48,160 

1160 DATA 53, 32,120,53, 76, 71,53, 29,29,29, 29,155 

1165 DATA 4,162, 65,160,53, 32,120,53 

1170 DATA 96, 76, 107,53, 160,194,193,196, 160, 203 

1175 DATA 197,217,253,32,32,32,80,82, 69, 83 

1180 DATA 83,32,160,210,212,206,160,155,4 

1185 DATA 162,82,160,53,32,120,53,32,203,53,76 

1190 DATA 0, 52,142, 68,3,134,208, 140, 69, 3, 132,209 

1195 DATA 160,0, 140,72,3, 140,73,3 

1200 DATA 177,208,201,4,240,6,238,72,3,200,208 

1205 DATA 244, 169, 11,162,0,141, 66,3,76 

1210 DATA 86, 228,162, 96,169, 12,157, 66, 3, 32, 86, 228 

1215 DATA 162,96,169,3,157,66,3,169 

1220 DATA 200,157, 68,3, 169, 53,157, 69, 3, 169,0 

1225 DATA 157,75,3,169,28,157,74,3,76 

1230 DATA 86, 228,83, 58, 0,162,0, 169, 5,157 

1235 DATA 66, 3,169, 0, 157, 68,3, 169,4,157 

1240 DATA 69, 3,169, 4,157,72,3, 169,0,157 
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1245 DATA 73, 3,32,86, 228,173,0,4, 96, 226 
1250 DATA 2,227,2,0,52,-1 


ROM OS to RAM OS Toggle 

The second program is a short Version ot the "RamMaster" also on the Gateway BBS; it turns your 
ROM OS into a RAM OS and traps RESET so that if you press it. it doesn't jump back to ROM 
When you press RESET, the routine leaves the block at 52224-53247 ($CC00-$CFFF) intact, so 
any altered character set you've loaded there will remain untouched. It also creates an 
AUTORUN.SYS file, so if you want it on the same disk as the BASIC switcher above, you'll have to 
rename it (line 30). The RESET handler routine loads into page 6 at byte 1616 ($650). Both 
programs can be loaded trom DOS with the "L" command. 

ROM to RAM OS Handler 

10 GRAPHICS 0: Dim A$ (10) :? "ROM TO RAM O/S HANDLER" 

15 Print "BY Matthew Ratcliff 3/25/85" 

20 Print :Print "GET DOS DISK READY AND PRESS RTN"; 

25 Input A$ 

30 TRAP 200:Open #1,8, 0, "D:AUTORUN.SYS" 

40 RESTORE 

50 Read A:If A<0 Then 100 
60 PUT #1,A: GoTo 50 

100 Close #1: Print "64K 'XL ROM->RAM O/S CONVERTER" 

105 Print "AUTORUN.SYS FILE COMPLETE." 

110 Print "BE SURE TO SAVE THIS LOADER" 

115 Print "AS A BACKUP!":End 
200 Print "UNEXPECTED ERROR 

205 Print PEEK(195):Print "AT LINE ";PEEK(186)+256*PEEK (187) 

210 End 

1000 DATA 255,255, 0,52, 105,53,169, 80, 133,2 

1005 DATA 133,216, 169, 6, 133, 3,133,217, 165,9 

1010 DATA 9, 2,133, 9, 160,0, 169, 144, 133, 222,169 

1015 DATA 52,133,223,173, 60, 53,133,214,177 

1020 DATA 222,145,216,230,222,208,2,230,223 

1025 DATA 230,216,208,2,230,217,198,214,208,236,76 

1030 DATA 91,52,205,225,244,170,210,225,244,167 

1035 DATA 243,160,210,207,205,173,190,210,193,205 

1040 DATA 160,200,225,238,228,236,229,242,160,242 

1045 DATA 229,225,228,249, 174, 155,4,162,56, 160 

1050 DATA 52,32, 61,53, 76, 136, 52, 160,160, 160,208 

1055 DATA 210,197,211,211,160,167,210,197,211 

1060 DATA 197,212,167,160,203,229,249,160,244 

1065 DATA 239, 160, 229,238,225,226,236, 229, 174, 160,160 

1070 DATA 155,4, 162,101,160, 52,32, 61,53, 96 

1075 DATA 169,80,133, 2, 169, 6, 133, 3,165,9 

1080 DATA 9, 2,133, 9, 120,169, 0,141,47,2, 133 

1085 DATA 16,141,0,212,141,14,210,141,14 

1090 DATA 212,133, 219, 169, 1,133, 66, 169, 192 

1095 DATA 133,217,169,204,133,218,160,0,240,81,169 

1100 DATA 216,133,217,132,218,230,219,208,71 

1105 DATA 169, 128,133, 16, 141, 14,210,169, 64,141,14 

1110 DATA 212,169,34,141,47,2,141,0,212,198 

1115 DATA 66, 88,162, 96, 169, 12, 157,66, 3,32 

1120 DATA 86, 228, 162, 96, 169, 3,157, 66, 3, 169 

1125 DATA 83, 141,0,4, 169, 58,141, 1,4,169 

1130 DATA 4, 157, 69, 3, 169, 0,157,75,3,157 

1135 DATA 68,3,169, 28, 157,74,3, 76,86, 228 

1140 DATA 132,216, 173, 1,211, 9, 1,141,1,211 

1145 DATA 177,216, 170,173, 1,211,41,254,141,1 

1150 DATA 211,138,145,216,230,216,208,230,230 

1155 DATA 217,165,218,197,217,208,222,165,219,240,135 

1160 DATA 208,143,173,142,68,3,134,212,140 

1165 DATA 69, 3, 132,213, 160, 0,140,72,3, 140,73 

1170 DATA 3,177,212,201,4,240,11,238,72,3 

1175 DATA 208,3, 238,73,3, 200,208,239, 169, 11 

1180 DATA 162,0, 141, 66, 3, 76, 86, 228,226,2,227 

1185 DATA 2,0,52,-1 


BASIC Revision B Fix 

This small program "fixes" your Revision B BASIC (see above) by copying BASIC ROM to RAM 
and writing the correct bytes into the location. This brings your BASIC B up to BASIC C, without 
needing the ROM Chips or cartridge to do so (I still recommend that you acquire a new Revision C 
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ROM from Atari). This means your BASIC is also alterable, since it is in RAM now. Matt the wizard 
does it again. I suggest you get onto the Gateway BBS and download his programs if you haven't 
already done so. Revision B BASIC to Revision C Converter 

10 REM 800XL & 64K-600XL REV.B(UGS) 

20 REM BASIC To REV.C CONVERTER. 

30 REM By Matthew J. W. Ratcliff 4/5/85 
40 REM THIS LOADER WILL CREATE AN 
50 REM AUTORUN.SYS FILE For YOU. 

60 REM ADVISÄBLE To MOVE DOWN RAMTOP 
70 REM WHEN In THE RAM/BASIC, SINCE 
80 REM SOME ATARI GRAPHICS COMMANDS 
90 REM WILL CLEAR RAM ABOVE RAMTOP. 

100 REM (i.e. POKE 106, PEEK(106)-4:GR.0-6) 

110 REM (i.e. POKE 106,PEEK(106)-16:GR.7-11) 

120 RESTORE 

130 GRAPHICS 0: Dim A$(10) 

140 ? "GET DOS DISK READY FOR REV.B TO C" 

150 ? "AUTORUN FILE AND PRESS RETURN KEY" 

160 TRAP 220: Input A$ 

170 Open #1,8,0,"D:AUTORUN.SYS" 

180 Read A:If A<0 Then 200 

190 PUT #1,A: GoTo 180 

200 Close #1:? "** ALL DONE **" 

210 ? "SAVE THIS LOADER AS A BACKUP":? "JUST IN CASE!":End 

220 ? "ERROR # ";PEEK(195);" AT LINE ";PEEK(186)+256*PEEK(187): End 

1000 DATA 255,255,0, 6, 130, 6, 169, 0, 133,2 

1010 DATA 169, 6, 133, 3, 173,250,3, 240,1, 96 

1020 DATA 169, 0, 133,216, 169, 160,133, 217,160,0 

1030 DATA 173,1,211,41,253,141,1,211,177,216 

1040 DATA 72, 173,1,211, 9,2,141,1,211,104 

1050 DATA 145,216,230,216,208,228,230,217,165,217 

1060 DATA 201,192,208,220,162,0, 169, 12,133, 218 

1070 DATA 160,0, 189, 95, 6, 133,216, 232, 189, 95 

1080 DATA 6, 133, 217,232, 189, 95, 6, 145,216, 232 

1090 DATA 198,218,208, 232,165, 9, 9,2,133,9 

1100 DATA 96,223,168,234,224,168,240,225,168,17 

1110 DATA 226, 168,234,41, 187,0,243, 191,0,244 

1120 DATA 191,0,245,191,0,246,191,0,247,191 

1130 DATA 0,248,191,0,249, 191,0, 226,2,227 

1140 DATA 2,0,6,-1 
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XL/XE Index 

This is an index by label And subject of the locations discussed In the XL/XE Addenda 
(Appendices 12-19). The numbers are decimal memory references, Not pages. 


ABUFPT 28 - 31 
ACMI interrupt 50220 
ACMISR 717, 728 
ACMVAR 1005 - 1016 
alternate character Set 619 
ATASCII 64329 

BASIC 50337 
BASIC bugs 43234 
BASIC disabled 1016, 54017 
BASICF 1016 

BASIC revision test 43234 
baud rate 64728 
BBYTEA 719, 720 
bitmap routines 63267 
blackboard mode 58481 
BMI 63267 

BOOT Error 50237, 50750 
BREAK key 49298 
BRKKY 566, 567 
buffer 63665 


C: 58432 
CARTCK 1003 

Cartridge 1003, 1018, 50217 
CASINI 2,3 
CASSBT 1002 
cassette boot 50798 
cassette handler 64728 
CBC 63665 

character Set 619, 756 
CHARSET1 54017, 57344 - 58367 
CHARSET2 52224 - 52991 
CHBAS 756 

checksum 52054, 65395, 65426, 65518 

CHLINK 1019, 1020 

CHSALT 619 

CIN 64728 

CIO 58591 

CKEY 1001 

CMCMD 07 

cold Start 49864, 49866, 55296 

COLINC 761 

CONSOL 53279 

Cont 64269 

CRETRY 668 


DERRF 1004 
device polls 746 

device registers 583, 746 - 749,53504 

DIO 50851, 50867, 51002 

disk boot 50571, 50619, 50729, 50747, 

disk sectors size 725 

display lists 38868, 60957, 64708 

DMASAV 733 

DOS 1792 - 7419 

DOS 3.0 3889 

DOSINI 12, 13 

DOSVEC 10, 11 

DRETRY 701 

DSCTLN 725, 726 

DVSTAT 746 - 749 

E: 50248$ 58368 


- 53758 
50777 


FDL 64708 
FINE 622 

fine Scrolling 620, 622 
FKDEF 96, 97 
floating point 55296 
floating-point tables 56090 
FP 55296 - 57343 
Function keys 96, 97, 64529 
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GBYTEA 719, 720 
Get Byte 51151 
GETCHAR 62026 
GINTLK 1018 
GPDW 58511 


hardware initialization 50394 

hardware Option jumpers 782 

hardware ROM vectors 55296 - 55324 

HDWSEL 53759 

HELPFG 732 

HELP key 732 

HIBYTE 648 

HIUSED 715, 716 

HNDLOD 745 

HWGET 53504 

HWPUT 53504 

HWRSET 53505 

HWSTAT 53505 

ICIO 58561 

identity bytes 49152 - 49163, 65518 - 65529 
IIN 58588 
IMASK 651 

interrupt handlers 49152 - 52223, 52992 - 53247 
interrupt vectors 512 - 551, 50251 
IRQ Processing 49196, 49312 
IRQ vector 65534 

JMPERS 782 
JVECK 652 

K: 58400 

keyboard click 731 
keyboard definition 121, 122, 

64337 

keyboard delay 555, 709 
keyboard disable 621 
keyboard handler 62205, 63665, 

64537 

keyboard repeat 730 

keyboard silence 731 

keyboard tables 64260, 64337 

KEYDEF 121, 122 

KEYDIS 621 

KEYREP 730 

RGB 62205 

KIR 64537 

KRPDEL 729 

LCOUNT 563 

LEDs 621, 756, 54017 

LNFLG 00 

LOADAD 721, 722 

loader routine 568, 581, 648, 

713 - 724, 745 
LOMEM 128, 129 
LTEMP 54, 55 

machine vectors 65530 
memo pad mode 58481 
memory management 54017 
MINTLK 1017 
modern flag 07 

NEWADR 654, 655 
NEWCOL 758, 759 
NEWQOW 757 
NGFLAG 01 
NMIs 65530 
NOCLIK 731 
NTSC register 98 
NTSC/PAL 60945 

Option key 50330, 53279 
OS 58368 - 65535 
OS variables 1005 - 1016 
OS vectors 65530Ä65535 
OUTCHAR 62128 
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P: 58416 

PADDL4-7 628 - 631 
PALNTS 89 

parallel bus handler 58511 
parallel bus Interrupts 585 

parallel device 51468, 51507, 51631, 51658, 53504, 55296, 58511 

PBI 55296 - 57243 

PBI vectors 55296 - 55324 

PBPNT 734 

PBUFSZ 735 

PDMSK 585 

PDVMSK 583 

PENTV 58502 

peripheral handler 51753, 59193, 61116 

PHE 61116 

PHINIV 58508 

PHR 59193 

PHUNLV 58505 

PIN 65177 

PIO 51507 

POKEY timers 49743, 49890, 49749 
PORTB 20480, 54017 
power-up vector 65532 
PPTMPA 588 

Print buffer 734, 735 
Printer Output 838 
PTIMOT 788 
PTRIG4-7 640 - 643 
PUPBT 829 - 831 

RECLEN 581 

redefined Function keys 96, 97 
redefined keyboard 121, 122 
RELADR 568, 569 
RESET 9, 12, 13 
RESET vector 65530 
RLADDR 586, 587 

ROM vectors (hardware) 55296 - 55324 
ROWINC 760 
RUNADR 713, 714 

screen editor 1000 

self-test 20480, 54017, 58496 - 58499 

self-test enabled 54017 

SELFTST 58481 

SHPDVS 584 

spares 590 - 618 

SRTIMR 555 

STICK2-3 634 - 635 

STRIG2—3 646 - 647 

SUPERF 1000 

TEMP2 787 

vector tables 58368 - 58508 
VPIRQ 568, 569 
VSFLAG 620 

ZCHAIN 74, 75 
ZHIUSE 717, 718 
ZLOADA 723, 724 
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25 


Label Index 


This is an index 
subroutines, And 
To page numbers. 


of the labels used To identify the various memory locations 
vectors In the Atari. The references are To decimal memory 
For an index by subject, see the Next index section. 


, register 
locations. 


s, 

Not 


Label 


Location 


ADDCOR 

ADRESS 

AF1 

AFP 

ALLPOT 

ANTIC 

APPMHI 

ARGOPS 

ATACHR 

ATAN 

ATRACT 

AUDC1 

AUDC2 

AUDC3 

AUDC4 

AUDCTL 

AUDF1 

AUDF2 

AUDF3 

AUDF4 

BFENLO/HI 

BFLAG 

BITMSK 

BIWTARR 

BLDADR 

BLDISP 

BLIM 

BLKBDV 

BOOT 

BOOT? 

BOOTAD 

BOTSCR 

BPTR 

BRCNT 

BRKKEY 

BRKKY 

BRUN 

BSIO 

BSIOR 

BUFADR 

BUFCNT 

BUFRFL 

BUFRLO/HI 

BUFSTR 

CART A 

CART B 

CARTRIDGES 

CASBUF 

CASENT 

CASETV 

CASFLG 

CAS INI 

CASORG 

CASSBT 

CAUX1 

CAUX2 

CBAUDL/H 

CCOMND 

CDEVIC 

CDTMA1 

CDTMA2 

CDTMF3 

CDTMF4 

CDTMF5 

CDTMV1 

CDTMV2 

CDTMV3 

CDTMV4 

CDTMV5 

CFB 

CH 


782 

100 , 101 
55878 
55296 
53768 

54272 - 54783 
14, 15 
128, 129 

763 
48759 
77 

53761 

53763 
537 65 

53767 

53768 
53760 

53762 

53764 
53766 
52, 53 

1792 
110 

1796, 1797 

1794, 1795 

1809 

650 

58481 

62159 

9 

578, 579 
703 
61 

1793 
17 

566, 567 
10060 
1900 
1906 
21,22 
107 
56 

50, 51 
108, 109 
40960 - 49151 
32768 - 40959 
32768 - 49151 
1021- 1151 
60292 
58432 

783 
2, 3 

61249 — 61666 
75 

572 

573 

750, 751 

571 

570 

550, 551 
552, 553 
554 
55 6 
558 

536, 537 
538, 539 
540, 541 
542, 543 
544, 545 
570 - 573 

764 
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CHI 

CH ACT 

CHACTL 

CHAR 

CHARSET 

CHBAS 

CHBASE 

CHKSNT 

CHKSUM 

CHKSUN 

CIOINT 

CIOINV 

CIOORG 

CIOV 

CIREAD 

CIRTN 

CIX 

CKEY 

CLMJMP 

COLAC 

COLBK 

COLCRS 

COLDST 

COLDSV 

COLINC 

COLOR 0-4 

COLPF 0-3 

COLPM 0-3 

COLRSH 

COMENT 

COMPUT 

CONSOL 

COS 

COUNTR 

CPYFIL 

CRETRY 

CRITIC 

CRSINH 

CSOPIV 

CS TAT 

CTIA 

DAUX1/2 

DBSECT 

DBUF 

DBUFLO/HI 

DBYTLO/HI 

DCB 

DCOMND 

DDEVIC 

DDMG 

DEGFLG 

DELFIL 

DELTAC 

DELTAR 

DFLADR 

DFLAGS 

DFLINK 

DFMCLS 

DFMDDC 

DFMGET 

DFMOPN 

DFMPUT 

DFMSDH 

DFMSTA 

DFSFLG 

DIGRT 

DINDEX 

DINI 

DINIT 

DINT 

DIRLST 

DISKINV 

DISKIV 

DLISTL/H 

DMACTL 

DMASK 

DMENU 

DOBOOT 

DOPEN 

DOS 


Label Index 240 

i 


754 

755 
54273 
762 

57344 - 58367 

756 
54281 
59 

49 

65528 

58534 

58478 

58434 - 59092 

58454 

58729 

58907 

242 

74 

6418 

114, 115 
53274 
85, 86 
580 
58487 
122 

708 - 712 
53270 - 53273 
53266 - 53269 
79 

58941 
60583 
53279 
48561 
126, 127 
9080 
54 
66 
752 
58493 
648 

53248 - 53503 
778, 779 
577 
7668 

772, 773 
776, 777 
768 - 779 
770 
768 
10690 
251 
8649 

119, 120 
118 

1810, 1811 
576 

1807, 1808 
2837 
2983 
2751 
2219 
2508 
1995 
2817 
1806 
241 
87 

62334 

60906 

2016 

8505 

58451 

58448 

54274, 54275 

54272 

672 

7951 - 8278 
62189 
62454 
5440 
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DOSINI 

DOSOS 

DOSVEC 

DPFM 

DRAW 

DRETRY 

DRKMSK 

DRVBYT 

DSKFMS 

DSKIF 

DSKORG 

DSKTIM 

DSKUTL 

DSPFLG 

DSTAT 

DSTATS 

DTIMLO 

DUN IT 

DUNUSE 

DUPFLG 

DVSTAT 

EDITRV 

EEXP 

EGETCH 

ENDFMS 

ENDPT 

ENDSTAR 

EOUTCH 

ERRFLG 

ERRNO 

ERRSAVE 

ESCFLG 

ESIGN 

EXP 

EXP 10 

FADD 

FASC 

FCB 

FCHRFLG 

FDIV 

FDSCHAR 

FEOF 

FILDAT 

FILDIR 

FILFLG 

FLDOP 

FLDOR 

FLD1P 

FLD1R 

FLPTR 

FMOVE 

FMUL 

FMZSPG 

FNDCODE 

FPI 

FPOINT 

FPSCR 

FPSCR1 

FPTR2 

FRE 

FREQ 

FRESECT 

FRO 

FR1 

FR2 

FRX 

FSTOP 

FSTOR 

FSUB 

FTYPE 

GETSECTOR 

GLBABS 

GPRIOR 

GRACTL 

GRAFM 

GRAFP 0-3 

GTIA 

HARDI 

HATABS 

HITCLR 


12, 13 

8309 

10 , 11 

11528 

64764 

55 

78 

1802 
24, 25 
60912 

60906 - 61047 
582 

26, 27 
766 
76 
771 

774 
769 

775 
5533 

746 - 749 

58368 

237 

63038 

5377 

116, 117 
142, 143 
63140 
575 

73, 4789 - 4816 

195 

674 

239 
56768 
56780 
55910 
55526 
4993-5120 

240 
56104 
3850 

63 
765 
5121 
695 
56717 
56713 
56732 
56728 
252, 253 
56758 
56027 

67 - 73 
3742 
557 62 

55296 - 57393 
1510 - 1515 
1516 - 1535 
254, 255 
218 - 223 

64 

4293 

212 - 217 
224 - 229 
230 - 235 
236 
56747 
56743 
55904 
62 

4358 

736 - 739 
623 

53277 
53265 

53261 - 53264 
53248 - 53503 
62081 
794 - 831 

53278 
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HOLDCH 

HOLD1 

HOLD2 

HOLD3 

HOLD4 

HOLD5 

HPOSM 0-3 

HPOSP 0-3 

HSCROL 

ICAX1Z 

ICAX2Z 

ICAX3Z/4Z 

ICAX5Z 

ICAX6Z 

ICBALZ/HZ 

ICBLLZ/HZ 

ICCOMT 

ICCOMZ 

ICDNOZ 

ICHIDZ 

ICPTLZ/HZ 

ICSTAZ 

IFP 

INBUFF 

INISAVE 

INITAD 

INITIO 

INSDAT 

INTEMP 

INTINV 

INTORG 

INTRVEC 

INVFLG 

IOCBO 

IOCB1 

IOCB2 

IOCB3 

IOCB4 

IOCB5 

IOCB6 

IOCB7 

IOCBS 

IRQEN 

IRQST 

ISRDON 

ISRODN 

ISRSIR 

ISRTD 

KBCODE 

KBDORG 

KEYBDV 

KEYDEL 

KGETC2 

KGETCH 

LBFEND 

LBPR1 

LBPR2 

LBUFF 

LDFIL 

LDMEM 

LINBUF 

Line 

LINZBS 

LISTDIR 

LKFIL 

LMARGN 

LOADFLG 

LOG 

LOG10 

LOGCOL 

LOGMAP 

LOMEM 

LPENH 

LPENV 

LMTR 

M0PF-M3PF 

M0PL-M3PL 

MEMFLG 

MEMLO 

MEMSAV 


Label Index 242 

I 


124 
81 
671 
669 

700 

701 

53252 - 53255 
53248 - 53251 
54276 

42 

43 

44, 45 

46 

47 

36, 37 
40, 41 
23 

34 
33 
32 

38, 39 

35 

55722 
243, 244 
6044, 6045 
738, 739 
6518 

125 
557 
58475 

59093 - 59715 
522, 523 
694 

832 - 847 
848-863 
864 - 879 
880 - 895 
896-911 
912 - 927 
928 - 943 
944 - 959 
832 - 959 
53774 
53774 
6630 
60048 

6691, 60177 

60113 

53769 

62436 - 65535 

58400 

753 

63197 

63202 

1535 

1406 

1407 

1408 - 1535 
10522 

6457 

583 - 622 
7588 
0 , 1 
3501 
10608 
82 

5535 

57037 

57041 

99 

690 - 693 
128, 129 

564 

565 
6432 

53248 - 53251 
53256 53259 
6046 

743, 744 
10138 


Converted and layouted 2006 by Andreas Bertelmann for ABBUC 







243 

Mapping the Atari 




MEMTOP 

144, 

145, 741 

MLTTMP 

102, 

103 

MONORG 

61667 

- 62435 

MWRITE 

5958 


NEWCOL 

97, 98 

NEWROW 

96 


NMIEN 

54286 


NMIRES 

54287 


NMIST 

54287 


NOCKSM 

60 


NSIGN 

238 


OLDADR 

94, 95 

OLDCHR 

93 


OLDCOL 

91, 92 


OLDROW 

90 


OPT 

5534 


OS 

55296 

- 65535 

OSRAM 

62100 


OUTBUFF 

128, 

129 

P0PF-P3PF 

53252 

- 53255 

P0PL-P3PL 

53260 

- 53263 

PACTL 

54018 


PADDL 0-7 

624 - 

631 

PAGE ONE 

256 - 

511 

PAGE SIX 

1536 

- 1791 

PAGE THREE 

768 - 

1023 

PAGE TWO 

512- 

767 

PAGE ZERO 

0 - 255 

PAL 

53268 


PBCTL 

54019 


PBPNT 

29 


PBUFSZ 

30 


PCOLR 0-3 

704 - 

707 

PENH 

54284 


PENV 

54285 


PIA 

54016 

- 54271 

PIRQ 

59123 


PIRQQ 

65470 


PLYARG 

1504 


PLYEVL 

56640 


PMBASE 

54279 


PNMI 

59316 


POKEY 

53760 

- 54015 

POKMSK 

16 


PORTA 

54016 


PORTB 

54017 


POT 0-7 

53760 

- 53767 

POTGO 

53771 


PRINTV 

58416 


PRIOR 

53275 


PRNBUF 

960 - 

999 

PRNORG 

61048 

- 61248 

PTABW 

201 


PTEMP 

31 


PTIMOT 

28 


PTRIG 0-7 

636 - 

643 

PWRUP 

61733 


RADFLG 

251 


RAM 

0 - 49151 

RAMLO 

4, 5 


RAMSIZ 

740 


RAMTOP 

106 


RANDOM 

53770 


RBLOKV 

58490 


RDDIR 

4206 


RDNXTS 

4111 


RDVTOC 

4235 


RECVDN 

57 


RENFIL 

9783 


RESET 

61723 


RMARGN 

83 


ROM 

49152 

- 65535 

ROWAC 

112, 

113 

ROWCRS 

84 


ROWINC 

121 


RTCLOK 

18, 1 

9, 20 

RUNAD 

736 - 

737 

RUNSTK 

142, 

143 

SABYTE 

1801 


SASA 

1804, 

1805 
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SAVADR 

SAVFIL 

SAVIO 

SAVMSC 

SCRENV 

SCRFLG 

SCROLL 

SDLSTL 

SDMCTL 

SEND 

SENDEV 

SERIN 

SEROUT 

SETUP 

SETVBL 

SETVBV 

SFDIR 

SFLOAD 

SHFAMT 

SHFLOK 

SIN 

SIOINV 

SIOORG 

SIOV 

SIZEM 

SIZP 0-3 

SKCTL 

SKREST 

SKSTAT 

SOUNDR 

SPARE 

SQR 

SRTIMR 

SSFLAG 

SSKCTL 

STACK 

STACKP 

STARP 

STATUS 

STCAR 

STICK 0-3 

STIMER 

STMCUR 

STMTAB 

STOPLN 

STRIG 0-3 

SUBTMP 

SWPFLG 

SYSVBL 

SYSVBV 

TABMAP 

TEMP 

TEMPI 

TEMP 2 

TEMP 3 

TESTVER2 

TIMER1 

TIMER2 

TIMFLG 

TINDEX 

TMPCOL 

TMPLBT 

TMPROW 

TMP XI 

TRAMSZ 

TRIG 0-3 

TS TAT 

TSTDAT 

TXTCOL 

TXTMSC 

TXTOLD 

TXTROW 

ULFIL 

VBREAK 

VCOUNT 

VCTABL 

VDELAY 

VDSLST 

VECTOR TBL 


Label Index 244 

i 


104, 105 
12078 

790 

88, 89 
58384 
699 
64428 
560, 561 
559 
60011 
58472 
53773 
53773 
4452 
59666 
58460 
3873 
5540 
111 
702 
48551 
58469 

59716 - 60905 

58457 

53260 

53256 - 53259 

53775 

53770 

53775 

65 

563, 568, 569, 581, 651 - 655, 

1000 - 1020, 1152 - 1279 

48869 

555 

767 

562 

256 - 511 

792 

140, 141 
48 

9986 

632 - 635 
53769 
138, 139 
136, 137 
186, 187 
644 - 647 
670 
123 
59345 
58463 
675 - 689 
80, 574 
786, 787 

788 

789 
10483 
780, 781 
784, 785 

791 
659 

697, 698 

673 

696 

668 

6 

53264 - 53267 

793 
7 

657, 658 

660, 661 

662 - 667 

656 

10648 

518, 519 

54283 

58496 

53276 

512, 513 

58368 - 58477 


713 


735, 745, 757 


761, 
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VIMIRQ 

VINTER 

VKYED 

VNDT 

VNTP 

VPRCED 

VSCROL 

VSERIN 

VSEROC 

VSEROR 

VTIMR1 

VTIMR2 

VTIMR4 

WBLKD 

WBLKI 

WTP 

WÄRMST 

WARMSV 

WBOOT 

WMODE 

WRTDOS 

WRTNXS 

WSYNC 

WTBÜR 

XCONT 

XDELETE 

XFORMÄT 

XITVBV 

XLOCK 

XMTDON 

XNOTE 

XPOINT 

XRENAME 

XUNLOCK 

ZBUFP 

ZDRVA 

ZFRO 

ZF1 


534, 535 
516, 517 
520, 521 
132, 133 
130, 131 
514, 515 
54277 
522, 523 
526, 527 
524, 525 
528, 529 
530, 531 
532, 533 
548, 549 
546, 547 
134, 135 
8 

58484 

10201 

649 

4618 

3988 

54282 

2591 

1798 - 1800 

3122 

3352 

58466 

3196 

58 

3331 
3258 
3033 
3203 
67, 68 
69, 70 
55876 
55878 
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26 Subject Index 


This is an index by subject. The reference; 

numbers. For an index To 

the location And : 

Subject 

Location 

ANTIC direct memory Access 

(DMA) 

559, 54272 

interrupts 

512, 513 

mode numbers 

87 

P/M graphics 

559, 54272 

ROM 

54272 - 

Attract mode 

54783 

77 - 79 

BASIC 

array table 

140, 141 

blackboard mode 

58481 

Cartridge 

40960 - 49151 

Error Code, Line 

186, 187, 195 

Floating Point routines 

48549 - 49145 

GoTo, GoSub 

142, 143 

graphics modes 

87 

jump To DOS 

10, 11 

Line numbers 

136, 137 

memory pointers 

128, 129, 144, 14! 

OPERATOR list 

42509 

page zero 

128 - 209 

program 

14, 15, 136 - 139 

program End 

14, 15, 144, 145 

runtime stack 

142, 143 

stack 

256 - 511 

Statement pointer, table 

136 - 139 

stopped Line 

186, 187 

String table 

140, 141 

TOKEN list 

42159 

variable name, value 
tables 

130 - 135 

Blackboard mode 
entry point 

58481 

Start vector 

10, 11 

BOOT 

cassette 

9, 12, 75 

disk boot initialization 

12, 13 

disk boot routine 

4, 5, 62159, 6218 

DOS vector 

9 

success flag 

9 

System lockup 

9 

BREAK key 

disable 

16, 53774 

enable 

16, 53774 

flag 

17, 53774 

forced 

53775 

interrupt 

16, 53774 

restored 

16, 53774 

shadow register 

16, 53774 

Status 

17, 48 

vector 

566, 567 

Buffers 

cassette 

1021 - 1151 

command frame 

570 - 573 

data 

50 - 53, 56 

device (SIO data) 

772, 773 

Line 

30, 583 - 622 

printer 

29, 960 - 999 

ZIOCB 

36, 37, 40, 

Cartridges 

A (left) cartridge 

41 

40960 - 49151 

B (right) cartridge 

32768 - 40959 

BASIC; see A cartridge 

test For presence 

6, 7, 61845 


740 


744 


locations, Not 
previous index 


To page 
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I 


Cassette 

baud rate 

beep count 

boot 

buffer 

buffer size 

buzzer 

End of file 

handler routines 

handler vector 

initialization vector 

inter-record gap 

load 

mode 

motor control 
Open For Input 
Read block entry 
record size 
run address 
Status register 
voice track 

Characters 

ATASCII 
auto repeat 
bit mapping 
blinking Text 
character sets 
character Set address 
colors 

control Codes 
control key 
control register 
Cursor inhibit 
hardware Code 
internal Code 
inverse 

invisible inverse 
last character Read, 
written 

logic Processing 
mode 

move Set To RAM 
Printer Output 
prior character Code 
ROM routines 
screen location 
shadow 
shift key 
tests 

translation of Code 
under Cursor 
upside down 
Checksum 

CIO 

command 

IOCBs 

utility initialization 

variables 

vector 

Clock 

attract mode 
realtime 

serial clock lines 
sound use 

Coldstart 

cassette boot 
disk boot 
entry point 
f lag 
powerup 

Color 

attract mode 
default values 
GTIA registers 


750 , 751 
64 , 65 

2 , 3 , 9 , 74 , 75 

61 , 1021 - 1151 

650 

61530 

63 

61249 - 61666 
58432 
2 , 3 
62 

2 , 3 

649 , 783 
54018 
58493 
58490 
1021 

10 , 11 , 12 , 13 

648 

53775 


763 , 57344 

764 

57344 

548 , 549 , 755 

756 , 57344 - 58367 

756 , 54281 

756 

766 

702 , 764 
755 
752 
764 

762 , 764 
694 

755 

763 

124 

755 , 54273 

756 
31 
754 

63038 - 63196 , 63202 

87 

756 

702 

65470 

57344 

93 

512 , 513 , 755 , 54273 
49 , 59 , 60 


23 

832 - 959 

58478 

43 

58454 


77 - 79 
18 , 19 , 20 
53775 
53768 


9 , 74 
9 

58487 

580 

61733 


77 - 79 
712 

53266 - 53274 
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player/missile shadows 

704 - 707 

playfield shadows 

708 - 712 

rotate 

77, 703 

screen mode 

87 

Command frame buffer 


(CFB) 

570 - 573 

Console keys 


cassette boot 

74 

Controller jacks 

54016, 54017 

CTIA see GTIA 


Cursor 


advance 

85 

character under 

93, 125 

column 

85, 86 

current position 

84 - 86, 94, 

End of Line 

125 

graphics 

90 - 92 

inhibit (disable) 

752 

LOCATE 

85, 86 

logical Line 

99 

opaque, transparent 

755, 54273 

out of ränge Error 

87 

previous position 

90 - 92 

row 

84 

Tab width 

201 

Text window 

85, 86, 123 

Device 


buffer 

772, 773 

Byte transfer 

776, 777 

command 

770 

Device Control Block 


(DCB) 

768 - 779 

drivers (adding) 

806 

Error Status 

746 

handler address table 

794 - 831 

handler routines 

58534 

handler vectors 

768 - 831 

retries 

55 

Status registers 

746 - 749, 7' 

timeout value 

747 

vector tables 

58368 - 5844' 

ZIOCB number 

33 

Direct Memory Access (DMA) 

graphics control 

53277 

ROM 

54272 

shadow 

559 

Disk (see also DOS) 


beep during I/O 

65 

boot 

9 - 13, 74, ' 

boot address 

578, 579 

boot continuation 

4, 5 

boot routine 

62159, 62189 

buffer 

21, 22, 1802 

f lags 

576, 577 

FMS page zero 

67 - 73 

FMS pointer 

24, 25 

handler commands 

778 

handler routines 

60906 - 6104' 

handler vector 

58448, 58451 

initialization address 

12, 13, 738, 

records Open 

1801 

retries 

54 

run address 

736 - 739 

Start vector 

10, 11 

timeout 

582 

Utilities 

26, 27 

vector 

10, 11 

verify routine 

1913 


Display handler (see also Characters, Screen) 
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logical Line map 

memory 

pixel mask 

RAM 

registers 
routines 
Text window 
vector 

Display List 

address 

enable 

entries 

instructions 

interrupts 

location 

lowest address 

reserving memory 

ROM tables 

screen mode 

scrolling 

size 

vertical Line count 

DOS (see also Disk) 
boot address 
boot record 
buffers 
burst I/O 
drives In System 
DUP.SYS RAM 
filename change 
files reserved 
FMS RAM 
initialization 
run address 
Start vector 
wildcard character 

DRAW command 

color of Line 
Cursor 

endpoint of Line 
f lag 
GR. 0 

ROM routines 
screen mode 

DUP.SYS 

load 

Errors 

BASIC 
device 
disk I/O 
SIO 

ESC (Escape) key 
control Codes without 
f lag 

FILL command (see also 
color of fill area 
color of Line 
endpoint of Line 
f lag 

Floating Point 

BASIC ROM 

degree Or radians flag 

page zero 

pointers 

RAM page five 

registers 

ROM (OS) 

trig functions 

FMS 

page zero buffer 
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690 - 693 
14, 15 
672 

656 - 703 

76, 80, 81, 99 - 105, 107 - 127 

62454 

656 - 667 

58384 


560, 561, 54274, 54275 
559 
81 

559 - 561 

512, 513, 560, 561, 54286, 54287 

560, 561, 54274 

14, 15 

106 

65093 

87 

54276, 54277 
88, 89 
54283 


578, 579 
1792 

6780 - 7547, 5121 - 5440, 7588 - 7923 
2952 - 2773 
1802 

5440 - 13062 
3818, 3822 
1801 

1792 - 5377 

12, 13, 738, 739 

736 - 737 

9-11 

3783 


763 

90 - 92 

84 - 86, 96 - 98 

695 

87 

64764 

87 


10 , 11 


186, 187, 195 

746 

73 

575 


766 

674 

DRAW) 

765 

763 

84 - 86, 96 - 98 
695 


48549 - 49145 

251 

210 - 255 

252 - 255 
1406 - 1535 

212 - 217, 224 - 229 

55296 - 57343 

251 


67 - 73 
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L 


pointer 

RAM 

24, 25 

1792 - 5377 


Graphics (see also player/missiles) 


display mode 

DRAW, DRAWTO, FILL 

IOCB 

Line plotting 
memory use 

player, missile shapes 
row And column plotting 
screen memory 
scroll 

Tab width 

XIO commands 

87 

85, 86, 96 - 98 

928 - 943 

112 - 122 

88, 89, 106 

53261 - 53265 

112 - 122 

14, 15, 123, 126, 127 

54276, 54277 

201 

96 - 98 

GTIA 

collisions 

examples 

mode selection 

ROM 

stick triggers 
test 

Text window 

53252 

623 

87, 623 

53248 - 53503 

53264 - 53267 

623 

87, 623 

Händlers 

interrupt handlers 

RESET 

ROM routines 

59093 - 59715 

794 

58534 - 59092 

Interrupts 

BREAK key disabled 

BREAK key vector 

Display List 
enabled 

handler routines 

IRQ 

NMI 

PIA (peripheral) 

POKEY 

RAM 

serial 

Status request 
timer 

VBLANK 

16 

566, 567 

512, 513 

16, 53774 

59093 - 59715 

16, 514-535, 53774, 59123, 59126 

512, 513, 54286, 59316 

54018, 54019 

16, 53774 

512 - 535, 566, 567 

16 

53774 

16 

546 - 549, 54286, 58460 - 58468, 59345 - 59715 

Inverse characters 

flag 

694 

IOCB 

graphics screen 

LIST, LOAD, LPRINT 

move 

page zero 

RAM 

screen editor 

928 - 943 

944 - 959 

58577 

32 - 47 

832 - 959 

832 - 847 

IRQ 

Break key vector 

Service routines 
vectors 

Jiffies, jiffy 

566, 567 

59123 - 59315 

514 - 535 

18 - 20 


Joystick see Stick 


Keyboard 

code 

console keys 
control key flag 
Controller 
delay flag 
display flag 

764, 53769 

53279 

702, 53769 

54016 

753 

766 


enable debounce,Scanning 562, 53775 
escape key flag 674 


handler routines 
handler vector 

Interrupts 
inverse toggle 

Option,Select,Start keys 

63197 - 65535 

58400 

16, 53774 

694 

53279 
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shift key flag 

Start, stop flag 

Status 

synchronization 
timer delay 

702, 53769 

767 

76 

54282 

555 

Light pen 

horizontal value 
vertical value 

564, 54284 

565, 54285 

Line 

bit map 
buffer 

Cursor 

logical Line 
margins 
plotting 
screen editor 
tabs 

690 - 693 

583 - 622 

99 

83 

83 

112 - 122, 126 

107 

201, 675 - 689 

Luminance 

attract mode 

77 - 79 

Machine language 

page six 
techniques 

1536 - 1791 

88 

Margins 

editing 

initialization 

left 

right 

scrolling 

83 

82, 83 

82 

83 

83 


Memo ry s e e RAM 


Monitor 

handler routines 

61667 - 62435 

Non-Maskable Interrupts 

DLI 

reset register 

Service routines 

Status 

VBLANK 

vectors 

(NMI) 

560, 561, 54286 

54287 

59316 - 59715 

54287 

546 - 549, 54286 

512, 513 

Operating System 

character Set 

Floating Point 
handlers 

ROM 

vectors 

57344 - 58367 

55296 - 57343 

58534 - 65535 

55296 - 65535 

58368 - 58533 


Paddies see Pots 


Page zero 

BASIC use 
buffer 

Floating Point use 

FMS registers 

IOCB 

RAM 

128 - 209 

21, 22 

210 - 255 

67 - 73 

32 - 47 

0 - 255 

Peripherais 

Controllers 

Interrupts 

ports 

54018, 54019 

53744 

54016, 54017 

PIA 

ROM 

stick 

paddle (pot) triggers 
ports 

54016 - 54271 

54016, 54017 

54016, 54017 

54016 - 54019 

Player/Missile Graphics 

character base 
collision clear 
collision detection 

(PMG) 

54279 

53278 

53248 - 53263 
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color registers 
disable, enable 

DMA 

fifth player 
graphic shape 
horizontal movement 
horizontal Position 
location 

memory reservation 

movement 

multicolor 

overlap 

priority 

resolution (Line) 
screen boundaries 
size, width 
vertical delay 
vertical motion 

703 - 707 

559, 53277 

54272 

623, 53275 

53261 - 53265 

53248 

53248 - 53255 

54279 

54279 

53248 

623, 53275 

623, 53275 

623, 53275 

559, 54272 

53248 

53256 - 53260, 54279 

53276 

53248 

Playfield 

enable 

priority 

size 

559 

623, 53275 

559 

PLOT 

screen mode 

87 

POKEY 

Interrupts 

pots 

ROM 

16, 514 - 535 

53760 - 53767 

53760 - 54015 

Polynomials 

random numbers 
sound dividers 

53770 

53761, 53768 

Pots (paddles) 

fast scan enable 

POKEY registers 
port state Read 
shadows 

Start Read sequence 
trigger latch 
triggers 
values 

562, 53775 

53760 - 53767 

53768 

624 - 631 

53771 

53277 

636 - 643, 54016 

624 

Powerup 

RAM size 

Warmstart 

6, 740 

8 

Print 

screen mode 

87 

Printer 

buffer 

character Output 
handler routines 
handler vector 

IOCB use 

sideways printing 

Status 

timeout 

29, 30, 960 - 999 

31 

61048 - 61248 

58416 

944 

30 

28, 30 

28 

Priority 

ROM 

shadow 

53275 

623 

RAM 

clear memory 

free memory, bottom 

free memory, top 

monitor 

pointers 

protected area(page six) 
reserving 

RAM top 
screen 
scrolling 
size 

88, 89, 106 

743, 744, 1792 

741 742 

0 , 1 

4, 5, 15, 128, 129 

1536 - 1791 

106, 743, 744 

106, 740 - 742 

88, 89 

699 

106, 740 
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test 

vector table 

4-7 

58496 

Random numbers 

poly counters 
register 

53768 

53770 

RESET 

coldstart 

DOS 

handler routine 
handler tables 
interrupt 
lockup 
margins 

Warmstart 

580 

10, 11 

61723 

794 

54286 

9 

83 

8, 58484 

Retry 

command frame 
device 

54 

55 

Screen (See also Cursor) 

bit mapping 
boundaries 
buffer 
clear memory 
clear screen 
color clocks 
control Codes 

GRAPHICS modes 
handler vector 

IOCB use 

Line buffer 
logical Line map 
lowest address 
memory restrictions 
memory use 
mode 

page zero RAM 

PAL compatible 
pixel justification 
pixel mask 
rows 

save routines 
screen modes 
scrolling 
size 

split screen 

Tab map 

Text rows 
vectors 

vertical Line counter 
wait synchronization 

110 

53248 

107 

88, 89 

88 

672 

766 

87 - 89, 106 

58368 

832, 928 

583 - 622 

690 - 693 

14, 15, 88, 89 

741, 742 

88 

87 

80 - 120 

53268 

111 

672 

703 

88, 89 

560, 561 

84, 89, 106, 699, 767, 54276, 54277, 64428 

76, 88, 89, 672 

123 

675 - 689 

703 

800, 803, 58368, 58384 

54283 

54282 

Serial port 

control 
data port 

Input/Output 

Interrupts 
reset Status 
shadow 

Status 

562, 53775 

790 

16, 53773 

16, 53774 

53770 

562 

53775 

SIO 

checksum 

command frame buffer 
data buffer 

49 

570 - 573 

50 - 53, 56 

Device Control Block 

(DCB) 

disk flags 

Error flag 
flags 

interrupt handler 
Interrupts 
routines 
send enable 
stack pointer 

Status 

768 - 779 

576, 577 

575 

56 - 60 

58475 

514 - 527 

59716 - 60905 

58472 

792 

48 
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timeouts 

28 

transmission flags 
utility initialization 
vector 

Software timers 

55 - 60 

58469 

58457 

536 - 545 

Sound 

audio control 
audio frequency 
beeps 
buzz 

cassette buzzer 
clock frequency 
console register 

CTRL-2 buzzer 
distortion 
filters 

I/O beeps 
keyboard Speaker 
margins 
octave ränge 
poly counters 

53761 - 53768 

53760 - 53768 

64, 65 

61530 

61530 

53768 

53279 

66 

53761 

53768 

65 

53279 

83 

53768 

53761 

Stack 


page one 
runtime 

256 - 511 

142, 143 

Status 

device 

display 

printer timeout 

SIO 

ZIOCB 

747 

76 

28 

48 

35 

Stick (joystick) 

attract mode 

PIA registers 

Read routines 
shadows 
trigger latch 
triggers 
values 

77 

54016, 54017 

632 

632 - 635 

53277 

644 - 647 

632 

Tabs 

comma spaces 
stop map 

201 

675 - 689 

Text window 

address 

Cursor 

GTIA 

margins 

plot 

rows available 
screen mode 
scrolling 

Tab width 

660, 661 

123, 656 - 658 

87 

82, 83 

87 

703 

87, 659 

699 

201 

Timeouts 

baud rate correction 

device 

disk 

printer 

storage 

value 

791 

748 

582 

28 

48 

28 

Timers 

attract mode 
baud rate 
critical Code 
interrupt enable 
jump vectors 

POKEY (hardware) 
realtime clock 
repeat 

Start hardware 
suspended 

System (Software) 

VBLANK 

77 

780 - 782, 784 - 787 

66 

16, 53774 

550 - 553 

16, 528 - 533, 53768 

18 - 20 

555 

53769 

66 

536 - 558 

66 
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550 - 558 
56 - 60 

Sticks) 

53264 - 53267 
53277 
636 - 643 
54016, 54017 
644 - 647 


vectors 

Transmission flags 

Triggers (see Pots, 

C/GTIA registers 
latches 
paddle (pot) 

PIA registers 
stick (joystick) 

Variables 

assign values 
list 

name table 
Statement table 
String And array table 
value table 

VBLANK 

attract mode 
clock 

critical section 
entry point 
Exit 

Interrupts 
key delay 
Set timers 
timer value 

Vectors 

cassette handler 
CIO 

command 

device handlers 
disk 

disk handler 
display handler 
Display List interrupt 
keyboard handler 
Printer handler 
screen editor 
warm Start 

Warmstart 

entry point 
f lag 

NMI check 
vector 


134 

132 

130 - 133 
136, 137 
140, 141 
134, 135 


77 - 79 
18 - 20 
66 

58463 

58466 

546 - 549, 54286 
753 

18, 58460 

0 , 1 


58432 

58454 

23 

794 - 831, 58368 - 58477 

10 , 11 

58448, 58451 

58384 

512, 513 

58400 

58416 

58368 

8, 54287 


58484 

8 

8, 54287 
8, 58484 
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Orderform 

COMPUTE! Books 
P.O. Box 5038 
F.D.R. Station 
New York, NY 10150 

Ask your retailer For these COMPUTE! Books. If he Or she has sold out, order directly from 
COMPUTE!. 


For Fastest Service 
Call Our TOLL FREE US Order Line 
1-800-346-6767 
In NY Call 212-887-8525 
Or Write COMPUTE! Books, 

P.O. Box 5038, F.D.R. Station, New York, NY 10150 
Quantity Title Price Total 


COMPUTE! ' s First Book of Atari (00-0) $12.95 _ 

COMPUTE! ' s Second Book of Atari (06-X) $12.95 _ 

COMPUTE! ' s Third Book of Atari (18-3) $12.95 _ 

COMPUTE!' s First Book of Atari Graphics (08-6) $12.95 _ 

COMPUTE!' s Second Book of Atari 

Graphics (28-0) $12.95 _ 

COMPUTE! ' s First Book of Atari Games (14-0) $12.95 _ 

COMPUTE!' s Atari Collection, Volume 1 (79-5) $12.95 

COMPUTE!' s Atari Collection, Volume 2 (029-7) $14.95 _ 

Machine Language For Beginners (11-6) $14.95 _ 

Second Book of Machine Language (53-1) $14.95 _ 

SpeedScript: The Word Processor 

For the Atari (003) $ 9.95 _ 

Mapping The Atari, Revised (004) $16.95 _ 

COMPUTE! ' s ST Programmer's Guide (023-8) $16.95 _ 

The Elementary Atari ST (024) $16.95 _ 

COMPUTE!'s Kids and the ST (386) $14.95 _ 

Elementary ST BASIC (343) $14.95 _ 

Introduction To Sound And Graphics 

On the Atari ST (035) $14.95 _ 


Add $2.00 per book shipping And handling. Outside US add 
$5.00 air mail Or $2.00 surface mail. 

NC residents add 4.5% sales tax_ 

Shipping & handling_ 

Total payment_ 

All Orders must be prepaid (money Order, check, Or Charge) . All 
payments must be In US funds. 

[] Payment enclosed Please Charge my: [] Visa [] MasterCard 
[] American Express 

Acct. No. _ Exp. Date _ 

Name _ 

Address _ 

City _ State _ Zip _ 

Country _ 

*Allow 4-5 weeks For delivery. Prices And availability subject To change without 

notice. 
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28 Backpage 

"The value of this book...lies...in the explanations.J expect to use this book often." Bill Wilkinson, 
an author of Atari BASIC and COMPUTE! columnist (from the introduction). 

Now revised to include the XL and XE series, this memory map and sourcebook was created to tili 
a need for a complete, comprehensiveguide to the memory locations in the Atari 400, 800, 

1200XL, 600XL, 800XL, 65XE, and 130XE personal Computers. Although parts of this information 
are available in other publications, no previos collection has provided complete cross references, 
detailed explana- tions, and a tutorial approach. 

This book serves as a doorway to understanding the inner workings of the Atari for the beginning 
programmer, as a tutorial for the intermediate, and as a reference work for the advanced. One of 
the joys of computing is that the beginner can become an intermediate, and the intermediate can 
become an expert with remarkable rapidity. This book can be one of the most valuable tools to aid 
any Atari programmer in making the transition to a new level of competence. 

The wealth of information available to Atari owners in technical manuals, recent books, and 
ongoing magazine coverage has two significant drawbacks: It is not collected in one handy 
reference and it is often difficult for the beginner to understand. Many times you're expected to be 
familiär with what's been printed elsewhere. 

Mapping The Atari, Revised Edition provides the most detailed discussion yet offered on almost 
every known memory location. For the first time, you can find explanations-in a clear, 
understandable style--telling you how to use all these memory locations. 

Mastering some of Atari's powerful, built-in capabilities such as player/missile graphics and display 
lists requires an understanding of how to manipulate specific memory locations. This book shows 
you how. 

While advanced programmers will find this book an indispensable resource manual, other, less 
experienced programmers will turn to it again and again for clarificatiom, instruction, advice, and as 
the definitive reference. 

ISBN 0-87455-004-1 
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1000-1020 94 
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1152-1535 95 

128-255 46 

130XE 221 

130XE 224 

1536-1791 95 

1792-2047 96 
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2048-8191 99 

256-511 54 
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400/800 OS 228 
40960-49151 106 
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512-535 54 

53248 - 53279 (GTIA or CTIA) 110 
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53280-53503 119 

53504-53759 119 

536 - 558 57 

53760 - 53775 (POKEY) 119 

53776-54015 126 
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54020-54271 128 

54272 - 54287 (ANTIC) 128 

54288 - 54303 134 
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559 - 623 60 
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704-712 

73 

713-735 
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85 
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87 
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88 
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800XL BASIC Switcher 231 
8192-32767 104 

832 - 959 89 

- 9 - 

960 - 999 94 
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Addenda 176 
ANTIC 128 

Assembler/Machine Language 20 
Atari BASIC 20 
Atari Microsoft BASIC 20 
AT ASCII 173 
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Backpage 260 
BASIC A + 20 

BASIC Software Toggle 231 
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Character set 136 
clock frequency 152 
Conversions 169 
CTIA 110 

■ D- 

Display list 165 
DOS 2.5 224 

■ E- 

Errata 176 

-F- 

Floating Point 135 
Foreword 8 
Forth 20 

-G- 

Graphics Memory Map 148, 163 
Graphics Modes 218 
GTIA 110 

-I- 

I/O Chips 109 
IC 109 

Index by label 239 

Index by subject 247 

Index XL/XE 235 

Internal Character Code Values 173 

Introduction 20 

■ L- 

LISP 20 

- M- 

machine cycle 152 

Memory Management On The 130XE 221 


Memory Map 224 
Music 161 

-N- 

New BASIC Commands for DOS 2.5 224 

Numerical Conversions 169 
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OS ROM 135 
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Page 1 54 

Page 2 54 

Page 3 85 
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Page 5 94, 95 
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Parallel Bus 214 
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RAMdisk 224 
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Timing 152 
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XL/XE Bugs 212 
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XL/XE Graphics Modes 218 
XL/XE Memory Map 190 
XL/XE Parallel Bus 214 


231 


Converted and layouted 2006 by Andreas Bertelmann for ABBUC 







Back Cover 



